GBase 8a MPP Cluster 运维命令 100 条

内容阅读

在知识库中专注阅读，并随时返回相关工具与课程

前言

GBase 8a MPP Cluster 是面向分析型场景的分布式数据库。它的运维对象不仅包括数据库和 SQL，还包括 Coordinator、gnode、gcware、数据分片、副本、DML/DDL Event、数据装载任务和重分布任务。

如果只按照普通 MySQL 的思路检查 SHOW PROCESSLIST，往往只能看到当前调度节点的信息，无法覆盖所有 Coordinator 和 gnode。真正的集群巡检还需要结合 gcadmin、gcmonit、gcluster_services 以及 information_schema 中的集群视图。

下面整理了 GBase 8a MPP Cluster DBA 常用的 100 条命令，覆盖 gccli 连接、集群服务、节点状态、分片、数据库对象、会话任务、空间、数据装载、用户权限、恢复模式、日志和操作系统巡检等场景。

本文以 GBase 8a MPP Cluster V9 系列常见用法为主。V8、V9 以及不同 V9 小版本在服务命令、工具参数、系统表字段和多 VC 管理方面可能存在差异，执行前应先确认现场版本。文中的 IP、用户、数据库、表名、目录和 Distribution ID 均为示例。

集群启停、恢复模式切换、分片调整、数据重分布、终止任务、删除对象和覆盖加载等操作风险较高，必须按照现场版本的官方管理员手册执行。

一、连接与基础信息

1. 使用 gccli 连接数据库

Bash

1gccli -h 192.168.1.10 -P 5258 -u dba -p

交互输入密码可以避免密码直接出现在 Shell 历史记录中。

2. 使用多个 Coordinator 地址连接

Bash

1gccli \
2  -h 192.168.1.10,192.168.1.11,192.168.1.12 \
3  -P 5258 -u dba -p

指定多个 IP 后，gccli 可以依次尝试连接，提高客户端连接可用性。

3. 直接执行一条 SQL

Bash

1gccli -h 192.168.1.10 -u dba -p \
2  -e "SELECT VERSION();"

4. 执行 SQL 文件

Bash

1gccli -h 192.168.1.10 -u dba -p \
2  -D appdb < appdb_init.sql

5. 查看 GBase 版本

SQL

1SELECT VERSION();

6. 查看当前数据库

SQL

1SELECT DATABASE();

7. 查看当前用户

SQL

1SELECT
2    USER(),
3    CURRENT_USER();

8. 查看所有数据库

SQL

1SHOW DATABASES;

9. 切换数据库

SQL

1USE appdb;

10. 查看当前时间

SQL

1SELECT
2    NOW(),
3    CURRENT_TIMESTAMP;

二、集群服务与进程

11. 查看当前节点全部服务状态

Bash

1gcluster_services all info

这是 V9 环境常用的节点服务检查入口。

12. 启动当前节点全部服务

Bash

1gcluster_services all start

13. 停止当前节点全部服务

Bash

1gcluster_services all stop

停服务前应确认节点角色、业务连接和集群整体状态。

14. 重启当前节点全部服务

Bash

1gcluster_services all restart

15. 查看 gcmonit 状态

Bash

1gcmonit --status

16. 查看 gcluster 调度进程

Bash

1ps -ef | grep '[g]clusterd'

17. 查看 gnode 数据库进程

Bash

1ps -ef | grep '[g]based'

18. 查看 gcware 进程

Bash

1ps -ef | grep '[g]cware'

V8 环境中相关进程可能是 corosync。

19. 查看同步服务进程

Bash

1ps -ef | grep '[g]c_sync_server'

20. 查看 GBase 相关监听端口

Bash

1ss -lntp | grep -E 'gclusterd|gbased|gcware'

具体端口应以安装配置为准。

三、gcadmin 集群状态与事件

21. 查看 gcadmin 帮助

Bash

1gcadmin --help

22. 查看 gcadmin 版本

Bash

1gcadmin --version

23. 查看集群总体状态

Bash

1gcadmin

重点确认节点状态、集群模式、分片和副本是否正常。

24. 查看 Coordinator 状态

Bash

1gcadmin showcluster c

25. 查看 gnode 状态

Bash

1gcadmin showcluster d

26. 查看 DML Event

Bash

1gcadmin showdmlevent 50

用于检查数据操作过程中记录的一致性和执行异常。

27. 查看 DDL Event

Bash

1gcadmin showddlevent 50

28. 查看 DML Storage Event

Bash

1gcadmin showdmlstorageevent 50

29. 查看故障倒换记录

Bash

1gcadmin showfailover

30. 查看集群锁

Bash

1gcadmin showlock

四、数据库、表与分布方式

31. 创建数据库

SQL

1CREATE DATABASE appdb;

32. 查看数据库中的表

SQL

1SHOW TABLES FROM appdb;

33. 按名称查找表

SQL

1SHOW TABLES FROM appdb LIKE '%order%';

34. 查看表结构

SQL

1DESC appdb.orders;

35. 查看完整建表语句

SQL

1SHOW CREATE TABLE appdb.orders;

36. 创建 HASH 分布表

SQL

1CREATE TABLE appdb.orders
2(
3    order_id BIGINT NOT NULL,
4    customer_id BIGINT NOT NULL,
5    order_date DATE,
6    amount DECIMAL(18,2)
7)
8DISTRIBUTED BY ('customer_id');

分布键应选择数据较均匀、关联和过滤经常使用的字段。

37. 创建复制表

SQL

1CREATE TABLE appdb.region_dict
2(
3    region_id INT,
4    region_name VARCHAR(100)
5)
6REPLICATED;

复制表适合数据量较小、更新不频繁并且经常参与关联的维表。

38. 查看表类型和 HASH 分布键

SQL

1SELECT
2    dbName,
3    tbName,
4    isReplicate,
5    hash_column
6FROM gbase.table_distribution
7WHERE dbName = 'appdb'
8  AND tbName = 'orders';

39. 查看表和分布信息

SQL

1SELECT *
2FROM information_schema.cluster_tables
3WHERE table_schema = 'appdb'
4  AND table_name = 'orders';

40. 查看各分片段空间

SQL

1SELECT *
2FROM information_schema.cluster_table_segments
3WHERE table_schema = 'appdb'
4  AND table_name = 'orders';

可以用它检查数据是否在各节点和分片间均匀分布。

五、会话与集群任务

41. 查看当前节点会话

SQL

1SHOW PROCESSLIST;

42. 查看完整会话 SQL

SQL

1SHOW FULL PROCESSLIST;

43. 查看详细会话

SQL

1SHOW DETAIL PROCESSLIST;

44. 查看所有 Coordinator 上的任务

SQL

1SELECT
2    coordinator_name,
3    id,
4    user,
5    host,
6    command,
7    start_time,
8    time,
9    state,
10    SUBSTRING(info, 1, 200) AS info
11FROM information_schema.coordinators_task_information
12WHERE command = 'query'
13ORDER BY time DESC
14LIMIT 20;

45. 查看所有 gnode 上的任务

SQL

1SELECT
2    node_name,
3    id,
4    user,
5    host,
6    command,
7    start_time,
8    time,
9    state,
10    SUBSTRING(info, 1, 200) AS info
11FROM information_schema.gnodes_task_information
12WHERE command = 'query'
13  AND info IS NOT NULL
14ORDER BY time DESC
15LIMIT 20;

46. 查看长时间运行的 Coordinator 查询

SQL

1SELECT
2    coordinator_name,
3    id,
4    user,
5    host,
6    time,
7    state,
8    info
9FROM information_schema.coordinators_task_information
10WHERE command = 'query'
11  AND time >= 300
12ORDER BY time DESC;

47. 按用户统计 Coordinator 任务

SQL

1SELECT
2    user,
3    COUNT(*) AS tasks
4FROM information_schema.coordinators_task_information
5WHERE command = 'query'
6GROUP BY user
7ORDER BY tasks DESC;

48. 终止指定连接

SQL

1KILL 12345;

执行前应先确认任务 ID、用户、SQL 和业务影响。

49. 查看当前连接信息

SQL

1SELECT
2    CONNECTION_ID(),
3    USER(),
4    DATABASE();

50. 通过 gccli 快速查看会话

Bash

1gccli -h 192.168.1.10 -u dba -p \
2  -e "SHOW FULL PROCESSLIST;"

六、变量、状态与空间

51. 查看系统变量

SQL

1SHOW VARIABLES;

52. 查看指定变量

SQL

1SHOW VARIABLES LIKE '%parallel%';

53. 查看系统状态

SQL

1SHOW STATUS;

54. 查看内存状态

SQL

1SHOW STATUS LIKE '%meminfo%';

55. 查看数据库表数量

SQL

1SELECT
2    table_schema,
3    COUNT(*) AS table_count
4FROM information_schema.tables
5WHERE table_schema NOT IN (
6    'information_schema',
7    'gbase'
8)
9GROUP BY table_schema
10ORDER BY table_count DESC;

56. 查看各数据库逻辑表空间

SQL

1SELECT
2    table_schema,
3    SUM(data_length) AS data_bytes,
4    SUM(index_length) AS index_bytes
5FROM information_schema.tables
6WHERE table_schema NOT IN (
7    'information_schema',
8    'gbase'
9)
10GROUP BY table_schema
11ORDER BY data_bytes DESC;

不同版本对相关字段的统计口径可能不同，应结合集群分片视图核对。

57. 查看大表排行

SQL

1SELECT
2    table_schema,
3    table_name,
4    table_rows,
5    data_length,
6    index_length
7FROM information_schema.tables
8WHERE table_schema = 'appdb'
9ORDER BY data_length DESC
10LIMIT 20;

58. 查看表字段

SQL

1SELECT
2    column_name,
3    column_type,
4    is_nullable,
5    column_default
6FROM information_schema.columns
7WHERE table_schema = 'appdb'
8  AND table_name = 'orders'
9ORDER BY ordinal_position;

59. 查看集群分片配置

Bash

1gcadmin showdistribution

60. 查看节点上的分片分布

Bash

1gcadmin showdistribution node

七、数据装载与导出

61. 从 FTP 文件装载数据

SQL

1LOAD DATA INFILE
2'ftp://loader:password@192.168.1.100//data/orders.csv'
3INTO TABLE appdb.orders
4FIELDS TERMINATED BY ','
5ENCLOSED BY '"'
6NULL_VALUE '\N';

生产环境不应在脚本和文章中保留真实密码。

62. 指定日期时间格式装载

SQL

1LOAD DATA INFILE
2'ftp://loader:password@192.168.1.100//data/orders.csv'
3INTO TABLE appdb.orders
4FIELDS TERMINATED BY ','
5ENCLOSED BY '"'
6NULL_VALUE '\N'
7DATETIME FORMAT '%Y-%m-%d %H:%i:%s';

63. 装载带毫秒的时间

SQL

1LOAD DATA INFILE
2'ftp://loader:password@192.168.1.100//data/events.csv'
3INTO TABLE appdb.events
4FIELDS TERMINATED BY ','
5NULL_VALUE '\N'
6DATETIME FORMAT '%Y-%m-%d %H:%i:%s.%f';

64. 查看当前装载进度

SQL

1SELECT
2    db_name,
3    tb_name,
4    ip,
5    state,
6    start_time,
7    progress,
8    total_size,
9    loaded_size,
10    loaded_records,
11    skipped_records
12FROM information_schema.load_status
13ORDER BY db_name, tb_name;

65. 查看历史装载结果

SQL

1SELECT
2    task_id,
3    db_name,
4    tb_name,
5    user,
6    host_ip,
7    start_time,
8    end_time,
9    elapsed_time,
10    total_size,
11    loaded_records,
12    skipped_records
13FROM information_schema.load_result
14WHERE start_time >= '2026-07-27'
15ORDER BY start_time DESC;

66. 检查装载错误行数

SQL

1SELECT
2    task_id,
3    db_name,
4    tb_name,
5    loaded_records,
6    skipped_records
7FROM information_schema.load_result
8WHERE skipped_records > 0
9ORDER BY start_time DESC;

67. 导出查询结果到服务器文件

SQL

1rmt:SELECT *
2FROM appdb.orders
3WHERE order_date >= '2026-07-01'
4INTO OUTFILE '/data/export/orders.csv'
5FIELDS TERMINATED BY ','
6ENCLOSED BY '"'
7NULL_VALUE '\N';

文件路径属于执行节点，执行前应检查目录权限和磁盘空间。

68. 使用 gccli 导出查询结果

Bash

1gccli -h 192.168.1.10 -u report_user -p \
2  -D appdb \
3  -e "SELECT * FROM orders LIMIT 1000" \
4  > orders.txt

69. 批量执行装载脚本

Bash

1gccli -h 192.168.1.10 -u loader -p \
2  -D appdb < load_orders.sql \
3  > load_orders.log 2>&1

70. 检查批量脚本错误

Bash

1grep -niE 'error|failed|exception' load_orders.log

八、用户、权限与对象管理

71. 查看用户

SQL

1SELECT
2    user,
3    host
4FROM gbase.user
5ORDER BY user, host;

系统权限表结构可能随版本变化，查询前可先 DESC gbase.user。

72. 创建用户

SQL

1CREATE USER 'appuser'@'%'
2IDENTIFIED BY 'Replace_With_Strong_Password';

73. 修改用户密码

SQL

1SET PASSWORD FOR 'appuser'@'%'
2= PASSWORD('Replace_With_New_Strong_Password');

具体密码语法应以当前版本的安全策略和官方手册为准。

74. 查看用户权限

SQL

1SHOW GRANTS FOR 'appuser'@'%';

75. 授予只读权限

SQL

1GRANT SELECT ON appdb.*
2TO 'report_user'@'%';

76. 授予读写权限

SQL

1GRANT SELECT, INSERT, UPDATE, DELETE
2ON appdb.*
3TO 'appuser'@'%';

77. 回收权限

SQL

1REVOKE INSERT, UPDATE, DELETE
2ON appdb.*
3FROM 'appuser'@'%';

78. 删除用户

SQL

1DROP USER 'appuser'@'%';

79. 查看存储过程

SQL

1SHOW PROCEDURE STATUS
2WHERE Db = 'appdb';

80. 查看函数

SQL

1SHOW FUNCTION STATUS
2WHERE Db = 'appdb';

九、分片、重分布与恢复模式

81. 导出指定 Distribution 配置

Bash

1gcadmin getdistribution 1 distribution_1.xml

1 为示例 Distribution ID，应先通过 showdistribution 确认。

82. 查看重分布命令帮助

Bash

1gcadmin rebalance --help

不同版本的重分布参数差异较大，必须先查看当前安装版本帮助。

83. 检查重分布相关子命令

Bash

1gcadmin --help | grep -i rebalance

GBase 8a 不同小版本的重分布参数和状态查询方式存在差异，应先确认当前安装版本实际提供的子命令，再按对应版本管理员手册执行。

84. 查看虚拟集群

Bash

1gcadmin showvc

多 VC 功能和子命令只适用于支持相应能力的版本。

85. 查看当前集群模式

Bash

1gcadmin

输出中应重点确认集群处于 NORMAL、RECOVERY 或其他维护状态。

86. 切换到恢复模式

Bash

1gcadmin switchmode recovery

该命令只应在官方恢复流程要求时执行，并且通常只在一个部署 gcware 的节点上执行一次。

87. 恢复完成后切回正常模式

Bash

1gcadmin switchmode normal

切换前必须确认恢复任务、节点状态和数据一致性已经满足要求。

88. 初始化节点数据映射

SQL

1INITNODEDATAMAP;

该命令用于安装初始化阶段，不是日常巡检命令，已有生产集群不要重复执行。

89. 查看集群 DML 一致性事件

Bash

1gcadmin showdmlevent

发现 Event 后，应结合表、节点、时间和同步服务日志判断是否需要恢复处理。

90. 查看集群 DDL 一致性事件

Bash

1gcadmin showddlevent

十、日志与操作系统巡检

91. 查看 gcluster 系统日志

Bash

1tail -200 "$GCLUSTER_BASE/log/gcluster/system.log"

实际安装目录应根据现场环境替换。

92. 查看 gcluster 引擎日志

Bash

1tail -200 "$GCLUSTER_BASE/log/gcluster/express.log"

93. 查看 gclusterd 日志

Bash

1tail -200 "$GCLUSTER_BASE/log/gcluster/gclusterd.log"

94. 查看审计日志

Bash

1tail -200 "$GCLUSTER_BASE/log/gcluster/gclusterd-audit.log"

95. 查看 gnode 日志

Bash

1tail -200 "$GNODE_BASE/log/gbase/express.log"

96. 查看同步服务日志

Bash

1tail -200 "$GNODE_BASE/log/gbase/syncserver.log"

97. 搜索近期错误

Bash

1grep -RniE 'error|fatal|failed|exception' \
2  "$GCLUSTER_BASE/log" "$GNODE_BASE/log" | tail -200

98. 查看主机 CPU 和内存

Bash

1uptime
2free -m
3top

99. 查看磁盘空间和 I/O

Bash

1df -h
2df -i
3iostat -x 1 5

应重点检查 Coordinator、gnode 数据目录、日志目录和装载文件目录。

100. 执行集群快速巡检

Bash

1gcadmin
2gcadmin showcluster c
3gcadmin showcluster d
4gcadmin showdistribution node
5gcadmin showdmlevent 20
6gcadmin showddlevent 20
7gcadmin showdmlstorageevent 20
8gcadmin showfailover
9gcadmin showlock

这些命令可以快速检查节点、分片、一致性事件、倒换记录和集群锁，但正式巡检还要结合会话任务、表空间、数据倾斜、装载任务、日志和操作系统资源综合判断。

结语

GBase 8a 的日常运维不能只停留在 SQL 层。SHOW PROCESSLIST 只能提供局部信息，完整排查需要同时查看 Coordinator、gnode、分片、副本和一致性 Event。

出现 SQL 卡顿时，应先判断任务卡在 Coordinator 还是 gnode；出现空间问题时，要检查各分片段是否均匀；出现数据一致性告警时，要结合 showdmlevent、showddlevent、同步服务和恢复日志定位。对于重分布、恢复模式和节点变更，应严格按照当前版本管理员手册执行。

官方资料

GBase 8a 官方文档：https://www.gbase.cn/docs/gbase-8a/
GBase 8a MPP Cluster 产品手册：https://cdn.gbase.cn/products/30/WYp0qy85K9ciqDMnYt463/GBase%208a%20MPP%20Cluster%E4%BA%A7%E5%93%81%E6%89%8B%E5%86%8C_V953.pdf
组件工具：https://www.gbase.cn/docs/gbase-8a/%E4%BA%A7%E5%93%81%E6%89%8B%E5%86%8C/admin-administrator-guide/admin-component-tools/
集群数据重分布：https://www.gbase.cn/docs/gbase-8a/%E4%BA%A7%E5%93%81%E6%89%8B%E5%86%8C/admin-administrator-guide/admin-cluster-node-management/admin-clustered-data-redistribution