GBase 8a MPP Cluster DBA 应该掌握的 100 条命令

GBase 8a MPP Cluster DBA 应该掌握的 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 连接数据库gccli -h 192.168.1.10 -P 5258 -u dba -p交互输入密码可以避免密码直接出现在 Shell 历史记录中。2. 使用多个 Coordinator 地址连接gccli \ -h 192.168.1.10,192.168.1.11,192.168.1.12 \ -P 5258 -u dba -p指定多个 IP 后gccli可以依次尝试连接提高客户端连接可用性。3. 直接执行一条 SQLgccli -h 192.168.1.10 -u dba -p \ -e SELECT VERSION();4. 执行 SQL 文件gccli -h 192.168.1.10 -u dba -p \ -D appdb appdb_init.sql5. 查看 GBase 版本SELECT VERSION();6. 查看当前数据库SELECT DATABASE();7. 查看当前用户SELECT USER(), CURRENT_USER();8. 查看所有数据库SHOW DATABASES;9. 切换数据库USE appdb;10. 查看当前时间SELECT NOW(), CURRENT_TIMESTAMP;二、集群服务与进程11. 查看当前节点全部服务状态gcluster_services all info这是 V9 环境常用的节点服务检查入口。12. 启动当前节点全部服务gcluster_services all start13. 停止当前节点全部服务gcluster_services all stop停服务前应确认节点角色、业务连接和集群整体状态。14. 重启当前节点全部服务gcluster_services all restart15. 查看 gcmonit 状态gcmonit --status16. 查看 gcluster 调度进程ps -ef | grep [g]clusterd17. 查看 gnode 数据库进程ps -ef | grep [g]based18. 查看 gcware 进程ps -ef | grep [g]cwareV8 环境中相关进程可能是corosync。19. 查看同步服务进程ps -ef | grep [g]c_sync_server20. 查看 GBase 相关监听端口ss -lntp | grep -E gclusterd|gbased|gcware具体端口应以安装配置为准。三、gcadmin 集群状态与事件21. 查看 gcadmin 帮助gcadmin --help22. 查看 gcadmin 版本gcadmin --version23. 查看集群总体状态gcadmin重点确认节点状态、集群模式、分片和副本是否正常。24. 查看 Coordinator 状态gcadmin showcluster c25. 查看 gnode 状态gcadmin showcluster d26. 查看 DML Eventgcadmin showdmlevent 50用于检查数据操作过程中记录的一致性和执行异常。27. 查看 DDL Eventgcadmin showddlevent 5028. 查看 DML Storage Eventgcadmin showdmlstorageevent 5029. 查看故障倒换记录gcadmin showfailover30. 查看集群锁gcadmin showlock四、数据库、表与分布方式31. 创建数据库CREATE DATABASE appdb;32. 查看数据库中的表SHOW TABLES FROM appdb;33. 按名称查找表SHOW TABLES FROM appdb LIKE %order%;34. 查看表结构DESC appdb.orders;35. 查看完整建表语句SHOW CREATE TABLE appdb.orders;36. 创建 HASH 分布表CREATE TABLE appdb.orders ( order_id BIGINT NOT NULL, customer_id BIGINT NOT NULL, order_date DATE, amount DECIMAL(18,2) ) DISTRIBUTED BY (customer_id);分布键应选择数据较均匀、关联和过滤经常使用的字段。37. 创建复制表CREATE TABLE appdb.region_dict ( region_id INT, region_name VARCHAR(100) ) REPLICATED;复制表适合数据量较小、更新不频繁并且经常参与关联的维表。38. 查看表类型和 HASH 分布键SELECT dbName, tbName, isReplicate, hash_column FROM gbase.table_distribution WHERE dbName appdb AND tbName orders;39. 查看表和分布信息SELECT * FROM information_schema.cluster_tables WHERE table_schema appdb AND table_name orders;40. 查看各分片段空间SELECT * FROM information_schema.cluster_table_segments WHERE table_schema appdb AND table_name orders;可以用它检查数据是否在各节点和分片间均匀分布。五、会话与集群任务41. 查看当前节点会话SHOW PROCESSLIST;42. 查看完整会话 SQLSHOW FULL PROCESSLIST;43. 查看详细会话SHOW DETAIL PROCESSLIST;44. 查看所有 Coordinator 上的任务SELECT coordinator_name, id, user, host, command, start_time, time, state, SUBSTRING(info, 1, 200) AS info FROM information_schema.coordinators_task_information WHERE command query ORDER BY time DESC LIMIT 20;45. 查看所有 gnode 上的任务SELECT node_name, id, user, host, command, start_time, time, state, SUBSTRING(info, 1, 200) AS info FROM information_schema.gnodes_task_information WHERE command query AND info IS NOT NULL ORDER BY time DESC LIMIT 20;46. 查看长时间运行的 Coordinator 查询SELECT coordinator_name, id, user, host, time, state, info FROM information_schema.coordinators_task_information WHERE command query AND time 300 ORDER BY time DESC;47. 按用户统计 Coordinator 任务SELECT user, COUNT(*) AS tasks FROM information_schema.coordinators_task_information WHERE command query GROUP BY user ORDER BY tasks DESC;48. 终止指定连接KILL 12345;执行前应先确认任务 ID、用户、SQL 和业务影响。49. 查看当前连接信息SELECT CONNECTION_ID(), USER(), DATABASE();50. 通过 gccli 快速查看会话gccli -h 192.168.1.10 -u dba -p \ -e SHOW FULL PROCESSLIST;六、变量、状态与空间51. 查看系统变量SHOW VARIABLES;52. 查看指定变量SHOW VARIABLES LIKE %parallel%;53. 查看系统状态SHOW STATUS;54. 查看内存状态SHOW STATUS LIKE %meminfo%;55. 查看数据库表数量SELECT table_schema, COUNT(*) AS table_count FROM information_schema.tables WHERE table_schema NOT IN ( information_schema, gbase ) GROUP BY table_schema ORDER BY table_count DESC;56. 查看各数据库逻辑表空间SELECT table_schema, SUM(data_length) AS data_bytes, SUM(index_length) AS index_bytes FROM information_schema.tables WHERE table_schema NOT IN ( information_schema, gbase ) GROUP BY table_schema ORDER BY data_bytes DESC;不同版本对相关字段的统计口径可能不同应结合集群分片视图核对。57. 查看大表排行SELECT table_schema, table_name, table_rows, data_length, index_length FROM information_schema.tables WHERE table_schema appdb ORDER BY data_length DESC LIMIT 20;58. 查看表字段SELECT column_name, column_type, is_nullable, column_default FROM information_schema.columns WHERE table_schema appdb AND table_name orders ORDER BY ordinal_position;59. 查看集群分片配置gcadmin showdistribution60. 查看节点上的分片分布gcadmin showdistribution node七、数据装载与导出61. 从 FTP 文件装载数据LOAD DATA INFILE ftp://loader:password192.168.1.100//data/orders.csv INTO TABLE appdb.orders FIELDS TERMINATED BY , ENCLOSED BY NULL_VALUE \N;生产环境不应在脚本和文章中保留真实密码。62. 指定日期时间格式装载LOAD DATA INFILE ftp://loader:password192.168.1.100//data/orders.csv INTO TABLE appdb.orders FIELDS TERMINATED BY , ENCLOSED BY NULL_VALUE \N DATETIME FORMAT %Y-%m-%d %H:%i:%s;63. 装载带毫秒的时间LOAD DATA INFILE ftp://loader:password192.168.1.100//data/events.csv INTO TABLE appdb.events FIELDS TERMINATED BY , NULL_VALUE \N DATETIME FORMAT %Y-%m-%d %H:%i:%s.%f;64. 查看当前装载进度SELECT db_name, tb_name, ip, state, start_time, progress, total_size, loaded_size, loaded_records, skipped_records FROM information_schema.load_status ORDER BY db_name, tb_name;65. 查看历史装载结果SELECT task_id, db_name, tb_name, user, host_ip, start_time, end_time, elapsed_time, total_size, loaded_records, skipped_records FROM information_schema.load_result WHERE start_time 2026-07-27 ORDER BY start_time DESC;66. 检查装载错误行数SELECT task_id, db_name, tb_name, loaded_records, skipped_records FROM information_schema.load_result WHERE skipped_records 0 ORDER BY start_time DESC;67. 导出查询结果到服务器文件rmt:SELECT * FROM appdb.orders WHERE order_date 2026-07-01 INTO OUTFILE /data/export/orders.csv FIELDS TERMINATED BY , ENCLOSED BY NULL_VALUE \N;文件路径属于执行节点执行前应检查目录权限和磁盘空间。68. 使用 gccli 导出查询结果gccli -h 192.168.1.10 -u report_user -p \ -D appdb \ -e SELECT * FROM orders LIMIT 1000 \ orders.txt69. 批量执行装载脚本gccli -h 192.168.1.10 -u loader -p \ -D appdb load_orders.sql \ load_orders.log 2170. 检查批量脚本错误grep -niE error|failed|exception load_orders.log八、用户、权限与对象管理71. 查看用户SELECT user, host FROM gbase.user ORDER BY user, host;系统权限表结构可能随版本变化查询前可先DESC gbase.user。72. 创建用户CREATE USER appuser% IDENTIFIED BY Replace_With_Strong_Password;73. 修改用户密码SET PASSWORD FOR appuser% PASSWORD(Replace_With_New_Strong_Password);具体密码语法应以当前版本的安全策略和官方手册为准。74. 查看用户权限SHOW GRANTS FOR appuser%;75. 授予只读权限GRANT SELECT ON appdb.* TO report_user%;76. 授予读写权限GRANT SELECT, INSERT, UPDATE, DELETE ON appdb.* TO appuser%;77. 回收权限REVOKE INSERT, UPDATE, DELETE ON appdb.* FROM appuser%;78. 删除用户DROP USER appuser%;79. 查看存储过程SHOW PROCEDURE STATUS WHERE Db appdb;80. 查看函数SHOW FUNCTION STATUS WHERE Db appdb;九、分片、重分布与恢复模式81. 导出指定 Distribution 配置gcadmin getdistribution 1 distribution_1.xml1为示例 Distribution ID应先通过showdistribution确认。82. 查看重分布命令帮助gcadmin rebalance --help不同版本的重分布参数差异较大必须先查看当前安装版本帮助。83. 检查重分布相关子命令gcadmin --help | grep -i rebalanceGBase 8a 不同小版本的重分布参数和状态查询方式存在差异应先确认当前安装版本实际提供的子命令再按对应版本管理员手册执行。84. 查看虚拟集群gcadmin showvc多 VC 功能和子命令只适用于支持相应能力的版本。85. 查看当前集群模式gcadmin输出中应重点确认集群处于 NORMAL、RECOVERY 或其他维护状态。86. 切换到恢复模式gcadmin switchmode recovery该命令只应在官方恢复流程要求时执行并且通常只在一个部署 gcware 的节点上执行一次。87. 恢复完成后切回正常模式gcadmin switchmode normal切换前必须确认恢复任务、节点状态和数据一致性已经满足要求。88. 初始化节点数据映射INITNODEDATAMAP;该命令用于安装初始化阶段不是日常巡检命令已有生产集群不要重复执行。89. 查看集群 DML 一致性事件gcadmin showdmlevent发现 Event 后应结合表、节点、时间和同步服务日志判断是否需要恢复处理。90. 查看集群 DDL 一致性事件gcadmin showddlevent十、日志与操作系统巡检91. 查看 gcluster 系统日志tail -200 $GCLUSTER_BASE/log/gcluster/system.log实际安装目录应根据现场环境替换。92. 查看 gcluster 引擎日志tail -200 $GCLUSTER_BASE/log/gcluster/express.log93. 查看 gclusterd 日志tail -200 $GCLUSTER_BASE/log/gcluster/gclusterd.log94. 查看审计日志tail -200 $GCLUSTER_BASE/log/gcluster/gclusterd-audit.log95. 查看 gnode 日志tail -200 $GNODE_BASE/log/gbase/express.log96. 查看同步服务日志tail -200 $GNODE_BASE/log/gbase/syncserver.log97. 搜索近期错误grep -RniE error|fatal|failed|exception \ $GCLUSTER_BASE/log $GNODE_BASE/log | tail -20098. 查看主机 CPU 和内存uptime free -m top99. 查看磁盘空间和 I/Odf -h df -i iostat -x 1 5应重点检查 Coordinator、gnode 数据目录、日志目录和装载文件目录。100. 执行集群快速巡检gcadmin gcadmin showcluster c gcadmin showcluster d gcadmin showdistribution node gcadmin showdmlevent 20 gcadmin showddlevent 20 gcadmin showdmlstorageevent 20 gcadmin showfailover gcadmin 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