返回首页

gbase数据、南大通用产品文档：GBase8ashowcluster 命令

更新日期：2024年09月11日

功能
显示集群节点信息。

GBase 8a MPP Cluster 产品手册
4 管理员指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
197
注意

当集群有一半或一半以上Coordinator 节点离线时，执行gcadmin 命
令将卡住不返回，发现集群中有Coordinator 节点离线时，请相关信
息确认故障类型及时修复；

参数c 与vc vcname 只能输入一个，同时输入会报错。
语法
gcadmin showcluster [c | vc vcname] [d] [f]
表4- 30 参数说明
参数名称
说明
c
仅显示集群coordinator 节点信息。
vc vcname
指定要查看信息的虚拟集群名字。
d
仅显示集群data 节点信息。
f
按照xml 格式显示集群节点信息。
示例
示例1：显示所有节点信息。
$ gcadmin showcluster
CLUSTER STATE:
ACTIVE
===========================================================
=====
|
GBASE COORDINATOR CLUSTER INFORMATION
|
===========================================================
=====
|
NodeName
|
IpAddress
| gcware | gcluster | DataState |
----------------------------------------------------------------
| coordinator1 | 172.168.83.11 |
OPEN
|
OPEN
|
0
|
----------------------------------------------------------------
| coordinator2 | 172.168.83.12 |
OPEN
|
OPEN
|
0
|
----------------------------------------------------------------
| coordinator3 | 172.168.83.13 |
OPEN
|
OPEN
|
0
|
----------------------------------------------------------------
===============================================
|
GBASE VIRTUAL CLUSTER INFORMATION
|
===============================================
|
VcName
| DistributionId |
comment
|
-----------------------------------------------
|
vc1
|
1
| vc1comments |
-----------------------------------------------
|
vc2
|
2
| vc2comments |

GBase 8a MPP Cluster 产品手册
4 管理员指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
198
-----------------------------------------------
2 virtual cluster: vc1, vc2
3 coordinator node
0 free data node
示例2:显示VC1 所有节点信息。
$ gcadmin showcluster vc vc1
CLUSTER STATE:
ACTIVE
VIRTUAL CLUSTER MODE:
NORMAL
===============================================
|
GBASE VIRTUAL CLUSTER INFORMATION
|
===============================================
|
VcName
| DistributionId |
comment
|
-----------------------------------------------
|
vc1
|
1
| vc1comments |
---------------------------------
===========================================================
=======
|
VIRTUAL CLUSTER DATA NODE INFORMATION
|
===========================================================
=======
|NodeName|
IpAddress
|DistributionId|gnode|syncserver|DataState|
------------------------------------------------------------------
| node1
|172.168.83.11|
1
|OPEN |
OPEN
|
0
|
------------------------------------------------------------------
| node2
|172.168.83.12|
1
|OPEN |
OPEN
|
0
|
------------------------------------------------------------------
2 data node
示例3：仅显示coordinator 节点信息。
$ gcadmin showcluster c
CLUSTER STATE:
ACTIVE
CLUSTER MODE:
NORMAL
===========================================================
=====
|
GBASE COORDINATOR CLUSTER INFORMATION
|
===========================================================
=====
|
NodeName
|
IpAddress
| gcware | gcluster | DataState |
----------------------------------------------------------------
| coordinator1 | 172.168.83.11 |
OPEN
|
OPEN
|
0
|
----------------------------------------------------------------
| coordinator2 | 172.168.83.12 |
OPEN
|
OPEN
|
0
|
----------------------------------------------------------------
| coordinator3 | 172.168.83.13 |
OPEN
|
OPEN
|
0
|
----------------------------------------------------------------

GBase 8a MPP Cluster 产品手册
4 管理员指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
199
3 coordinator node
示例4：显示vc2 的data 节点信息。
$ gcadmin showcluster vc vc2 d
CLUSTER STATE:
ACTIVE
VIRTUAL CLUSTER MODE:
NORMAL
===============================================
|
GBASE VIRTUAL CLUSTER INFORMATION
|
===============================================
|
VcName
| DistributionId |
comment
|
-----------------------------------------------
|
vc2
|
2
| vc2comments |
-----------------------------------------------
===========================================================
=======
|
VIRTUAL CLUSTER DATA NODE INFORMATION
|
===========================================================
=======
|NodeName|
IpAddress
|DistributionId|gnode|syncserver|DataState|
------------------------------------------------------------------
| node1
|172.168.83.13|
2
|OPEN |
OPEN
|
0
|
------------------------------------------------------------------
| node2
|172.168.83.14|
2
|OPEN |
OPEN
|
0
|
------------------------------------------------------------------
2 data node
示例5：按照xml 格式显示data 节点信息。
$ gcadmin showcluster vc vc2 d f


ACTIVE
NORMAL


vc2
2
vc2comments




node1
172.168.83.13
2
OPEN
OPEN

GBase 8a MPP Cluster 产品手册
4 管理员指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
200
0


node2
172.168.83.14
2
OPEN
OPEN
0


2

 摘要：
如果当前执行的查询存在多个结果，返回“真”
，而且应用程序必须调用
gbase_next_result()来获取结果。
 语法：



GBase 8a 程序员手册C API 篇
南大通用数据技术股份有限公司

- 27 -
gs_bool gbase_more_results(GBASE *gbase);
 参数：
 返回值：
如果存在多个结果，
返回
“真”
（1）
，
如果不存在多个结果，
返回
“假”
（0）
。

GBase JDBC API 实现要点
GBase JDBC 通过了Sun's JDBC 兼容性测试套件中的测试。然而，在许多
地方，关于如何实现特定功能，JDBC 规范并没有给出明确的规定，因此存在一
定程度的实现上的灵活性。
本节将在接口层面上讲述关于特定的实施方案中用户使用GBase JDBC 的
方式。

Blob
可以在创建连接时通过设定参数emulateLocators=true 来提高Blob 类型
的效率。通过设置这个参数，驱动会推迟加载真正的Blob 数据，直到你调用
（getInputStream(),
getBytes()等方法）的时候数据才会真正加载到blob 数
据流中。

GBase 8a 程序员手册JDBC 篇
南大通用数据技术股份有限公司

- 25 -
如果使用这个参数必须满足如下条件：
必须使用带有列值的列别名，在你编写的用于检索Blob 的SELECT 中，将
列值设为Blob 列的真实名称。SELECT 只能从单表检索，该表必须有1 个主键，
而且SELECT 必须涵盖构成主键的所有列。随后，驱动程序将延期加载实际的
Blob 数据，
直至检索了Blob 并在其上调用了检索方法为止
（getInputStream(),
getBytes(),等）
。
例如：
SELECT id, 'data' as blob_data from blobtable
Blob 的实例不允许“原地”调整（它们是“副本”
，正如
DatabaseMetaData.locatorsUpdateCopies()方法所指明的那样）
。因此，应使
用对应的PreparedStatement.setBlob()或ResultSet.updateBlob()（对于可
更新结果集）方法，将变化保存到数据库中。

CallableStatement
当通过CallableStatement 接口连接GBase 时，支持存储过程，不支持函
数，函数可以通过PreparedStatemen 调用。

Clob
Clob 实例不允许修改（它们是复本，就像
DatabaseMetaData.locatorsUpdateCopies()方法所指明的那样）
。因此，用户
可以使用对应的PreparedStatement.setClob() 方法把变化保存回数据库。
GBase JDBC API 没有提供ResultSet.updateClob()支持。

Connection
按照JDBC 规范，如果在这个连接上调用了closed()，那么它只返回true。
如果用户需要确定这个连接是否还有效，用户应该使用一个简单的查询，如
SELECT 1。如果连接已不再有效的话，驱动会抛出一个异常。
在GBase 8a JDBC8.3.81.x 版本之后在jdk1.6 及以上环境中运行时，可以
调用boolean isValid(int timeout)方法来检查一个连接是否是有效。

GBase 8a 程序员手册JDBC 篇


- 26 -

南大通用数据技术股份有限公司

DatabaseMetaData
DatabaseMetaData 提供数据库的结构信息。
外键信息(getImportedKeys、
getExportedKeys()和getCrossReference())
仅仅对GsDB 类型的表有效，但是驱动是通过SHOW CREATE TABLE 来获取相关信
息的，所以当其他存储引擎支持外键，驱动程序同样能支持他们。

Driver
使用Class.forName("com.gbase.jdbc.Driver")加载驱动，在使用GBase
8a