GBase 集群 readonly 模式与正常模式在线切换实操

在 GBase 8a MPP Cluster 的生产运维中，为保障数据安全，常在备份、集群巡检等场景将集群切换至 readonly（只读）模式，操作完成后需切回正常读写模式。很多运维同学担心模式切换会影响业务运行，本文结合 GBase 集群的专属管理工具gcadmin，详细讲解 readonly 模式与正常模式的在线切换步骤、状态校验方法，以及生产环境的操作注意事项，全程无需停机，实现业务无感知切换。

一、集群模式切换的核心工具与权限要求

GBase 集群的模式切换通过gcadmin工具实现，该工具部署在 Coordinator 节点，需以集群安装用户（默认gbase）执行，操作前需确保gcware服务正常运行，可通过gcware_services status校验服务状态。

集群支持三种运行模式：NORMAL（正常读写）、READONLY（只读）、RECOVERY（恢复），本次重点讲解READONLY与NORMAL的互切，切换命令为集群全局生效，无需逐节点操作。

二、完整切换流程（以 readonly 切 normal 为例）

步骤 1：查看集群当前运行模式（前置校验）

执行以下命令查看集群模式，确认当前为READONLY模式后再执行切换操作，避免无效操作：

# 查看全局集群模式
gcadmin showcluster
# 多VC集群查看指定VC模式（替换vc1为实际VC名称）
gcadmin showcluster vc vc1

执行结果中VIRTUAL CLUSTER MODE字段为当前模式，若显示READONLY，则可继续下一步。

步骤 2：在线切换为正常读写模式

# 单VC/全局集群切换
gcadmin switchmode normal
# 多VC集群指定VC切换
gcadmin switchmode normal vc vc1

命令执行后秒级生效，集群自动同步模式状态至所有节点，无需重启任何数据库进程（gcluster/gcware/gbase）。

步骤 3：验证切换结果（核心确认）

再次执行gcadmin showcluster，若VIRTUAL CLUSTER MODE变为NORMAL，则说明切换成功，集群已恢复正常读写能力，可执行 DDL/DML/DQL 所有操作。

三、生产环境操作注意事项

1. 业务影响：切换过程为在线操作，对正在运行的只读查询无中断、无影响；readonly 模式下等待执行的写操作会进入队列，切换后自动执行，无需重新提交；

2. 操作节点：仅需在部署gcware服务的任意一个 Coordinator 节点执行，无需在所有节点重复操作；

3. 权限控制：必须使用集群安装用户gbase执行，普通用户无模式切换权限；

4. 反向切换：若需将正常模式切为 readonly 模式，命令为gcadmin switchmode readonly [vc VC名称]，适合备份、数据校验等场景；

5. 异常处理：若切换命令执行失败，先检查gcware服务状态，再查看集群节点是否正常在线，排除节点故障后重新执行即可。

四、配套运维命令

# 查看集群所有进程状态
gcluster_services all info
gcware_services all info
# 查看VC详细信息（含模式、节点、资源）
gcadmin showvc

GBase 集群的模式切换设计充分考虑了生产环境的高可用需求，通过gcadmin实现的在线切换，既保障了数据操作的安全性，又最大程度降低了对业务的影响，只需遵循 “先校验、再操作、后验证” 的三步原则，即可实现平稳切换。