CREATE DATA SOURCE
功能描述
创建一个新的外部数据源对象,该对象用于定义GaussDB 200要连接的目标库信息。
注意事项
- Data Source名称在数据库中需唯一,遵循标识符命名规范,长度限制为63字节,过长则会被截断。
- 只有系统管理员或初始用户才有权限创建Data Source对象。且创建该对象的用户为其默认属主。
语法格式
1 2 3 4 | 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。
- OPTIONSData Source对象的选项字段,创建时可省略,如若指定,其关键字如下:
- optname
选项名称。
取值范围:dsn, username, password, encoding。不区分大小写。
- dsn对应odbc配置文件中的DSN。
- username/password对应连接目标库的用户名和密码。
GaussDB 200在后台会对用户输入的username/password加密以保证安全性。该加密所需密钥文件可以使用系统默认自带的文件,也可以通过gs_guc生成,并在生成后通过 gs_om部署到集群所有节点。
- encoding表示与目标库交互的字符串编码方式(含发送的SQL语句和返回的字符类型数据),此处创建对象时不检查encoding取值的合法性,能否正确编解码取决于用户提供的编码方式是否在数据库本身支持的字符编码范围内。
- optvalue
选项值。
取值范围:空或者非空字符串。
- optname
示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | --创建一个空的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
查看更多:华为GaussDB 200 SQL语法
「喜欢这篇文章,您的关注和赞赏是给作者最好的鼓励」
关注作者
【版权声明】本文为墨天轮用户原创内容,转载时必须标注文章的来源(墨天轮),文章链接,文章作者等基本信息,否则作者和墨天轮有权追究责任。如果您发现墨天轮中有涉嫌抄袭或者侵权的内容,欢迎发送邮件至:contact@modb.pro进行举报,并提供相关证据,一经查实,墨天轮将立刻删除相关内容。