CREATE DATA SOURCE

    注意事项

    • Data Source名称在数据库中需唯一,遵循标识符命名规范,长度限制为63字节,过长则会被截断。
    • 只有系统管理员或初始用户才有权限创建Data Source对象。且创建该对象的用户为其默认属主。
    • 当在OPTIONS中出现password选项时,需要保证openGauss每个节点的GAUSSHOME/bin目录下存在datasource.key.cipher和datasource.key.rand文件,如果不存在这两个文件,请使用gsguc工具生成并使用gsssh工具发布到openGauss每个节点的GAUSSHOME/bin目录下存在datasource.key.cipher和datasource.key.rand文件,如果不存在这两个文件,请使用gsguc工具生成并使用gsssh工具发布到openGauss每个节点的GAUSSHOME/bin目录下。

    参数说明

    • src_name

      新建Data Source对象的名称,需在数据库内部唯一。

      取值范围:字符串,要符标识符的命名规范。

    • TYPE

      新建Data Source对象的类型,可缺省。

      取值范围:空串或非空字符串。

    • OPTIONS

      Data Source对象的选项字段,创建时可省略,如若指定,其关键字如下:

      • optname

        选项名称。

        • dsn对应odbc配置文件中的DSN。

        • username/password对应连接目标库的用户名和密码。

          openGauss在后台会对用户输入的username/password加密以保证安全性。该加密所需密钥文件需要使用gs_guc工具生成并使用gs_ssh工具发布到openGauss每个节点的$GAUSSHOME/bin目录下。username/password不应当包含’encryptOpt’前缀,否则会被认为是加密后的密文。

        • encoding表示与目标库交互的字符串编码方式(含发送的SQL语句和返回的字符类型数据),此处创建对象时不检查encoding取值的合法性,能否正确编解码取决于用户提供的编码方式是否在数据库本身支持的字符编码范围内。

      • optvalue

        选项值。

    1. postgres=# CREATE DATA SOURCE ds_test1;
    2. --创建一个Data Source对象,含TYPE信息,VERSIONNULL
    3. postgres=# CREATE DATA SOURCE ds_test2 TYPE 'MPPDB' VERSION NULL;
    4. --创建一个Data Source对象,仅含OPTIONS
    5. postgres=# CREATE DATA SOURCE ds_test3 OPTIONS (dsn 'openGauss', encoding 'utf8');
    6. --创建一个Data Source对象,含TYPE, VERSION, OPTIONS
    7. --删除Data Source对象。
    8. postgres=# DROP DATA SOURCE ds_test1;
    9. postgres=# DROP DATA SOURCE ds_test2;
    10. postgres=# DROP DATA SOURCE ds_test4;

    相关链接

    , DROP DATA SOURCE