更新日期：2024年09月11日
通过限定数据库对象（表、视图、同义词或例程）的名称，您可访问外部数据库中的任何
表或例程。
当外部表与当前数据库位于同一数据库服务器上时，您必须以数据库名称和冒号限定对象
名称。例如，要引用不是本地数据库的数据库中的表，下列 SELECT 语句访问来自外部数
据库的信息：
SELECT name, number FROM salesdb:contacts
在此示例中，查询从表 contacts 返回数据，该表在数据库 salesdb 中。
远程数据库服务器是不是当前数据库服务器的任何数据库服务器。当外部表在远程数据库
服务器上时，您必须以数据库服务器名称和数据库名称来限定数据库对象的名称，如下例
所示：
SELECT name, number FROM salesdb@distantserver:contacts
在此示例中，查询从表 contacts 返回数据，该表在远程数据库服务器 distantserver 上的数
据库 salesdb 中。
要了解关于如何在外部数据库中指定数据库对象的语法和规则，请参阅《GBase 8s SQL 指
南：语法》。
语法 [d number] [extension] [pattern
gcadmin distribution
1|2] [db_user user_name] [db_pwd password] [vc vc_name]
表 4-18 参数说明
参数名称
说明
gcChangeInfo.xml
生成distribution 的gnode 节点信息文件。集群安装成功后，执行安
装操作命令的节点上，在安装包目录下，会生成一个
gcChangeInfo.xml 文件。该文件为xml 格式，其根标签为
描述生成distribution 的gnode 节点信息；子标签为
描述的是机架与
gnode 节点对应关系。安装后生成的
gcChangeInfo.xml 中仅有一个
节点信息，在使用pattern 1 模式生成distribution 时，可按机器部署
情况插入多个
签下。
p number
每个数据节点存放的分片数量，最小值为1，p 值乘数据节点数不大
于65535，
即集群总分片数不大于65535，
否则gcadmin 将报错退出。
d number
每个分片的备份数量，取值为0，1 或2。若不输入参数d，默认值为
1。
pattern number
生成distribution 所使用模式，取值为1 或2，pattern 1 为负载均衡模
式，pattern 2 为高可用模式。若不输入参数pattern，默认使用pattern
1 生成distribution。
extension
生成的新distribution 将原有分片尽可能分布到原节点上。
db_user user_name
生成新distribution 时需传入数据库用户名。
db_pwd password
如果数据库密码不为空，生成新distribution 时需要在执行命令时传
GBase UP 产品手册 4 管理员指南
文档版本04（2021-04-21） 南大通用数据技术股份有限公司 156
参数名称
说明
入数据库密码。
密码中的特殊字符需要加转义字符。
密码为空时不需
传入该参数，只需传入数据库用户名。
vc vc_name
指定生成distribution 的虚拟集群。
功能
安装完集群，生成distribution 时，需要使用该命令进行操作。
注意
此命令需要切换到dbaUser 用户下，才能正确执行。若使用其它用户执行生成
distribution 命令，将提示用户切换到dbaUser 用户执行该命令，并报错退出；
若使用兼容模式，
安装完集群后直接生成distribution，
会将内所有free node 加入到默
认vc 中。
生成distribution 模式
生成distribution 有pattern 1，pattern 2 和编写distribution 配置信息文件三种模式。
使用编写distribution 配置信息文件方式生成distribution 时，
需手工编写一个配置文
件，描述每个分片及其备份分片存放的节点信息。
pattern 1
pattern 1 为负载均衡模式，此模式下gcChangeInfo.xml 中的每个rack 中的节点为一
组，
每个rack中的节点上主分片的备份分片1存放到gcChangeInfo.xml中下一个rack
中的节点上，备份分片2 存放到gcChangeInfo.xml 中上一个rack 中的节点上。
gcChangeInfo.xml 中的第一个rack 的上一个rack 为最后一个rack，最后一个rack
的下一个rack 为第一个rack。
使用pattern 1 模式生成distribution，
每节点主分片数
（即参数p）
必须小于每个rack
的节点数，以此来保证备份分片分布均匀。每个rack 包含的节点数尽可能相同，若
gcChangeInfo.xml 文件中有多余1 个rack 的节点数与其它rack 不同，gcadmin 将会
提示用户系统性能可能会下降，需用户确认后才能生成distribution。
GBase UP 产品手册 4 管理员指南
文档版本04（2021-04-21） 南大通用数据技术股份有限公司 157
示例
在安装好集群后，在执行安装操作的节点上，安装包目录下会生成一个包含所有
gnode 节点信息的gcChangeInfo.xml 文件，如下所示：
根据实际机架和机器部署情况，在该文件中插入
GBase UP 产品手册 4 管理员指南
文档版本04（2021-04-21） 南大通用数据技术股份有限公司 158
使用pattern 1 和该修改后的gcChangeInfo.xml 文件生成distribution 如下所示：
$ gcadmin distribution gcChangeInfo.xml p 1 d 2 pattern 1
gcadmin generate distribution ...
NOTE: node [192.168.153.129] is coordinator node, it shall be data node too
NOTE: node [192.168.153.130] is coordinator node, it shall be data node too
gcadmin generate distribution successful
生成distribution 后，可使用showdistribution 和showdistribution node 命令查
看生成的distribution 信息，如下所示：
$ gcadmin showdistribution
Distribution ID: 1 | State: new | Total segment num: 6
Primary Segment Node IP Segment ID Duplicate Segment node IP
=====================================================================
===============
| 192.168.153.128 | 1 | 192.168.153.134 |