ALTER DATA SOURCE
功能描述
修改Data Source对象的属性和内容。
属性包括：名称和属主；
内容包括：类型、版本和连接选项。
注意事项
- 只有初始用户、系统管理员和属主才拥有修改Data Source的权限。
- 修改属主时，新的属主用户必须是初始用户或系统管理员。
- 当在OPTIONS中出现password选项时，需要保证Vastbase每个节点的$GAUSSHOME/bin目录下存在datasource.key.cipher和datasource.key.rand文件，如果不存在这两个文件，请使用vb_guc工具生成并发布到每个节点的$GAUSSHOME/bin目录下。
语法格式
ALTER DATA SOURCE src_name
[TYPE 'type_str']
[VERSION {'version_str' | NULL}]
[OPTIONS ( {[ ADD | SET | DROP ] optname ['optvalue']} [, ...] )];
ALTER DATA SOURCE src_name RENAME TO src_new_name;
ALTER DATA SOURCE src_name OWNER TO new_owner;
参数说明
src_name
待修改的Data Source的名称。
取值范围：字符串，需要符合标识符的命名规范。
TYPE
将Data Source原来的TYPE修改为指定值。
取值范围：空串或非空字符串。
VERSION
将Data Source原来的VERSION修改为指定值。
取值范围：空串或非空字符串或NULL。
OPTIONS
修改OPTIONS中的字段：增加（ADD）、修改（SET）、删除（DROP），且字段名称optname需唯一，具体要求如下：
增加字段：ADD可以省略，待增加字段不能已经存在了；
修改字段：SET不可省略，待修改字段必须存在；
删除字段：DROP不可省略，待删除字段必须存在，且不能指定optvalue；
src_new_name
新的Data Source名称。
取值范围：字符串，需符合标识符命名规范。
new_user
对象的新属主。
取值范围：字符串，有效的用户名。
示例
1、创建一个空Data Source对象。
CREATE DATA SOURCE ds_test1;
2、修改名称。
ALTER DATA SOURCE ds_test1 RENAME TO ds_test;
3、修改属主。
CREATE USER user_test1 IDENTIFIED BY 'Gs@123456';
ALTER USER user_test1 WITH SYSADMIN;
ALTER DATA SOURCE ds_test OWNER TO user_test1;
4、修改TYPE和VERSION。
执行此语句需预先使用
vb_guc generate命令生成datasource文件，此处以如下命令为例：gs_guc generate -S 'Gs@123456' -D $GAUSSHOME/bin -o datasource
ALTER DATA SOURCE ds_test TYPE 'MPPDB_TYPE' VERSION 'XXX';
5、添加字段。
ALTER DATA SOURCE ds_test OPTIONS (add dsn 'gaussdb', username 'test_user');
6、修改字段。
ALTER DATA SOURCE ds_test OPTIONS (set dsn 'unknown');
7、删除字段。
ALTER DATA SOURCE ds_test OPTIONS (drop username);
8、删除Data Source和user对象。
DROP DATA SOURCE ds_test;
DROP USER user_test1;
