功能描述

创建一个新的外部数据源对象，该对象用于定义GaussDB 200要连接的目标库信息。

注意事项

• Data Source名称在数据库中需唯一，遵循标识符命名规范，长度限制为63字节，过长则会被截断。
• 只有系统管理员或初始用户才有权限创建Data Source对象。且创建该对象的用户为其默认属主。

语法格式

CREATE DATA SOURCE src_name
    [TYPE 'type_str']
    [VERSION {'version_str' | NULL}]
    [OPTIONS (optname 'optvalue' [, ...])];

参数说明

• src_name

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

  取值范围：字符串，要符标识符的命名规范。

• TYPE

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

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

• VERSION

  新建Data Source对象的版本号，可缺省或NULL值。

  取值范围：空串或非空字符串或NULL。

• OPTIONS
  Data Source对象的选项字段，创建时可省略，如若指定，其关键字如下：

  • optname

    选项名称。

    取值范围：dsn, username, password, encoding。不区分大小写。

    • dsn对应odbc配置文件中的DSN。
    • username/password对应连接目标库的用户名和密码。

      GaussDB 200在后台会对用户输入的username/password加密以保证安全性。该加密所需密钥文件可以使用系统默认自带的文件，也可以通过gs_guc生成，并在生成后通过 gs_om部署到集群所有节点。

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

    选项值。

    取值范围：空或者非空字符串。

示例

--创建一个空的Data Source对象，不含任何信息。
CREATE DATA SOURCE ds_test1;
--创建一个Data Source对象，含TYPE信息，VERSION为NULL。
CREATE DATA SOURCE ds_test2 TYPE 'MPPDB' VERSION NULL;
--创建一个Data Source对象，仅含OPTIONS。
 CREATE DATA SOURCE ds_test3 OPTIONS (dsn 'GaussDB 200', encoding 'utf8');
--创建一个Data Source对象，含TYPE, VERSION, OPTIONS。
CREATE DATA SOURCE ds_test4 TYPE 'unknown' VERSION '11.2.3' OPTIONS (dsn 'GaussDB 200', username 'userid', password 'pwd@123456', encoding '');
--删除Data Source对象。
DROP DATA SOURCE ds_test1;
DROP DATA SOURCE ds_test2;
DROP DATA SOURCE ds_test3;
DROP DATA SOURCE ds_test4;

相关链接

ALTER DATA SOURCE, DROP DATA SOURCE