gbase数据、南大通用产品文档：GBase8s插入行

INSERT 将新的一行或多行添加到表。该语句有两个基本功能。它可使用您提供的列值创
建单个的新行，或可使用从其他表选择的数据创建一组新的行。

功能描述
创建一个新的外部数据源对象，该对象用于定义GBase 8c 要连接的目标库信息。
注意事项

Data Source 名称在数据库中需唯一，遵循标识符命名规范，长度限制为63 字节，过长
则会被截断。

只有系统管理员或初始用户才有权限创建Data Source 对象。且创建该对象的用户为其
默认属主。

当在OPTIONS 中出现password 选项时，需要保证GBase 8c 每个节点的
$GAUSSHOME/bin 目录下存在datasource.key.cipher 和datasource.key.rand 文件，如果
不存在这两个文件，
请使用gs_guc 工具生成并使用gs_ssh 工具发布到GBase 8c 每个节
点的$GAUSSHOME/bin 目录下。
语法格式

GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
863
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 对应连接目标库的用户名和密码。
GBase 8c 在后台会对用户输入的username/password 加密以保证安全性。该加密所需密
钥文件需要使用gs_guc 工具生成并使用gs_ssh 工具发布到GBase 8c 每个节点的

GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
864
$GAUSSHOME/bin 目录下。username/password 不应当包含'encryptOpt'前缀，否则会被认为
是加密后的密文。
encoding 表示与目标库交互的字符串编码方式（含发送的SQL 语句和返回的字符类型
数据）
，此处创建对象时不检查encoding 取值的合法性，能否正确编解码取决于用户提供的
编码方式是否在数据库本身支持的字符编码范围内。

optvalue
选项值。
取值范围：空或者非空字符串。
示例
--创建一个空的Data Source 对象，不含任何信息。
gbase=#CREATE DATA SOURCE ds_test1;
--创建一个Data Source 对象，含TYPE 信息，VERSION 为NULL。
gbase=#CREATE DATA SOURCE ds_test2 TYPE 'MPPDB' VERSION NULL;
--创建一个Data Source 对象，仅含OPTIONS。
gbase=# CREATE DATA SOURCE ds_test3 OPTIONS (dsn 'openGauss', encoding 'utf8');
--创建一个Data Source 对象，含TYPE, VERSION, OPTIONS。
gbase=#CREATE DATA SOURCE ds_test4 TYPE 'unknown' VERSION '11.2.3' OPTIONS (dsn
'openGauss', username 'userid', password 'pwd@123456', encoding '');
--删除Data Source 对象。
gbase=#DROP DATA SOURCE ds_test1;
gbase=#DROP DATA SOURCE ds_test2;
gbase=#DROP DATA SOURCE ds_test3;

GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
865
gbase=#DROP DATA SOURCE ds_test4;

使用 RESTORE_POINT_DIR 配置参数来更改目录的路径名，在升级到新版本服务器失败时，
恢复点文件将置于这个目录。仅当启用 CONVERSION_GUARD 配置参数时，GBase
8s 将恢复
点文件存储在指定目录的一个子目录中，以服务器号为子目录名称
onconfig.std 值
$GBS_DATA/tmp
值
目录的完整路径名
生效
编辑 onconfig 文件并重启数据库服务器之后。
用法
您可更改目录，例如，如果您认为 $GBS_DATA/tmp 没有恢复点数据所需的充足空间。如果
您想要更改目录，则必须在初始化升级到一个新版本服务器之前更改。您不可在升级期间
更改目录。
当升级开始时，RESTORE_POINT_DIR 配置参数中指定的目录必须为空。如果该目录包含任
何以前升级的恢复点文件，则必须在新升级开始新的恢复点之前移除这些文件。
重要：
空目录是进行升级的先决条件，从失败的升级恢复时则不是。失败的升级之后，在您尝试
运行 onrestorept 实用程序之前不清空 RESTORE_POINT_DIR 目录。