gbase数据、南大通用产品文档：GBase8a在VC1 上创建distribution

操作场景
多VC 模式，需要在每个VC 下创建distribution。
操作步骤
步骤1
编辑vc1 的创建distribution 的配置文件gcChangeInfo_vc1.xml。在指定VC 中创建
distribution 时，创建distribution 的配置文件gcChangeInfo_vc1.xml 中的node IP 与
创建VC 的配置文件中的node IP 一致。
示例：编辑在vc1 上创建distribution 的配置文件gcChangeInfo_vc1.xml 内容如下：
$cd gcinstall
$cp gcChangeInfo.xml gcChangeInfo_vc1.xml
$vi /opt/gcinstall/gcChangeInfo_vc1.xml











步骤2
在安装目录下，执行创建distribution 命令。
gcadmin distribution

[d num] [pattern 1|2]
表3- 10 参数说明
参数名称
描
述
gcChangeInfo.xml
指定生成distribution 规则的配置文件。
p number
每个数据节点存放的分片数量，最小值为1。
d number
每个分片的备份数量，取值为0，1 或2。若不输入参数d，
默认值为1。

GBase 8a MPP Cluster 产品手册
3 集群安装升级与卸载
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
78
参数名称
描
述
pattern number
生成distribution 所使用模式，
取值为1 或2，pattern 1 为负载
均衡模式，
pattern 2 为高可用模式。
若不输入参数pattern，
默
认使用pattern 1 生成distribution。
vc vcname
要创建distribution 的vc 名称。
说明

gcadmin distribution 是gcadmin 的子命令，详细说明请参考4.3.1 gcadmin
章节。
执行结果如下：
$cd /opt/gcinstall
$ gcadmin distribution gcChangeInfo_vc1.xml p 1 d 1 vc vc1
gcadmin generate distribution ...
NOTE: node [192.168.146.21] is coordinator node, it shall be data node too
NOTE: node [192.168.146.20] is coordinator node, it shall be data node too
gcadmin generate distribution successful
说明

在某个VC 上创建distribution 时，gcChangeInfo_vc1.xml 文件中的node ip
要与创建VC 时配置文件中的node ip 一致；

创建distribution 时必须指定vc name,当集群只有一个vc 时，默认在该vc
上生成distribution 可以不指定vcname。

UDTMetaData 和 UDRMetaData 类中的许多 setXXX() 方法具有相应的 getXXX() 方法，用
于获取现有不透明类型和 UDR 的特性。
UDTMetaData 类中的 getXXX() 方法

GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 185 -

下表总结了 UDTMetaData 类中可用的 getXXX() 方法。对于 field 参数，1 表示内部数据结
构中第一个字段，
2 是第二个字段，
依次类推。
有关 SQL 名称的详细信息，
请参阅 SQL 名
称。
获取的信息
方法签名
其它信息
内部数据结构中的字段
计数
public int
getFieldCount()
如果没有字段，则返回 0
内部数据结构中的字段
名称
public String
getFieldName
int field) throws
SQLException
如果名称不存在，则返回 NULL
内部数据结构中的字段
数据类型代码
public int getFieldType
(int field) throws
SQLException
数据类型代码来自
类 com.gbasedbt.lang.IfxTypes.
。如果数据类型不存在，则返回 -1
内部数据结构中字段的
数据类型名称
public String
getFieldTypeName
(int field) throws
SQLException
如果名称不存在，则返回 NULL
对于字符类型：
字段中的
最大字符数；对于
date-time 或 interval
类型： 编码限定符
public int
getFieldLength
(int field) throws
SQLException
如果未设置长度，则返回 -1
不透明类型的 SQL 名称 public String
getSQLName()
如果未设置名称，则返回 NULL
JAR 文件的 SQL 名称
public String
getJarFileSQLName()
如果未设置名称，则返回 NULL
不透明类型的 Java™ 类
的名称
public String
getClassName()
如果未通过 setClassName() 设
置类名，则返回sqlname（缺省值）。
如果未通过 setSQLName() 设置
SQL 名称，则返回 NULL
固定长度的不透明类型
public int getLength() 如果未设置长度，则返回 -1

GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 186 -

获取的信息
方法签名
其它信息
的长度
不透明类型的对齐方式
public int
getAlignment()
如果未设置对齐方式，则返回 -1
有关对齐方式代码，请参阅对齐值。

已通
过 setSupportUDR()
指定为支持 UDR 的方法
对象组
public Method[]
getSupportUDRs()
有关支持的 UDR 的详细信息，请参
阅从现有代码创建不透明类型中
setSupportUDR() 的描述。
如果未指
定支持 UDR，则返回 NULL
通
过 setSupportUDR()
指定为支持 UDR 的
Java 方法的 SQL 名称
public String
getSupportUDRSQLName
(Methodmethod) throws
SQLException
如果未设置名称，则返回 NULL
UDRMetaData 类中的 getXXX() 方法
要获取有关 UDR 的信息，请使用下表中的方法。
获取的信息
方法签名
其它信息
指定为不透明类型的 UDR
的
java.lang.Method.Refle
ct 方法组
public Method[] getUDRs()
调
用 UDTMetaData.setUDR()
为不透明类型指定 UDR。
如果没有指定 UDR 则返回
NULL。
Java™ 方法的 SQL 名称
public String
getUDRSQLName(Method method
) throws SQLException
如果没有为 UDR 方法对象
指定 SQL 名称，则返回
NULL

包括在 GBase 8s JDBC Driver 中的 Intervaldemo.java 程序展示如何插入以及如何从两类
INTERVAL 数据类型选择。