一、状态含义
通过
gcadmin 命令查看集群状态时，数据节点的 DataState 字段用于标识节点整体数据的健康状态：- 正常值为 0：该节点所有分片数据正常，主副本完全一致
- 值为 1：该节点存在未解决的数据故障事件（DML 数据不一致、DDL 表结构不一致或存储层异常），节点内部分片的主副本数据出现差异，数据处于不可靠状态。集群会自动绕过异常分片，通过可用副本提供服务，业务通常不会中断但性能会下降。
二、常见触发原因
该状态本质是主副本数据同步中断导致的不一致，典型触发场景包括：
- 服务器异常断电、操作系统强制重启、数据库进程被异常终止
- 网络中断、网络抖动超时，导致主副本同步链路断开
- 数据磁盘空间占满、文件系统损坏、磁盘硬件故障
- 系统 CPU/IO 负载过高，数据同步任务超时失败
- 人为误操作（删除 / 修改数据文件、违规执行分片底层操作）
三、标准排查步骤
1. 确认节点基础服务状态
先执行
gcadmin 查看集群全貌，重点确认异常节点的 gnode 服务状态：- 如果
gnode状态为CLOSE：优先启动数据节点服务，服务恢复后集群会自动触发数据同步gcluster_services gbase start - 如果
gnode状态为OPEN：直接进入下一步定位具体故障。
2. 定位具体故障事件
执行以下三组命令，精准定位异常的类型、所属库表和对应分片，这是后续处理的核心依据：
# 查看DML数据不一致事件（最常见场景）
gcadmin showdmlevent
# 查看DDL表结构不一致事件
gcadmin showddlevent
# 查看存储层数据不一致事件
gcadmin showdmlstorageevent输出结果会包含事件 ID、异常库表名、分布 ID、故障节点 IP 等关键信息。
3. 查看自动同步进度
GBase 集群自带自动恢复机制，节点服务恢复后会自动通过 syncserver 执行数据比对与同步。
同步日志路径：$GBASE_HOME/log/gnode/syncclient_*.log
搜索对应表分片的关键字，若日志末尾出现 Sync Table ... Success 字样，代表同步完成，DataState 会自动变回 0。
四、分级处理方案
场景 1：临时故障，等待自动修复
如果是网络闪断、节点短时宕机等临时故障，服务恢复后集群会自动执行数据同步，多数小表可在数分钟内自动恢复。
建议观察 10~30 分钟，期间重复执行 gcadmin showdmlevent 确认事件是否在逐步减少。
场景 2：同步卡住，手动触发重同步
如果故障事件长时间（超过 1 小时）未消失，说明自动同步任务卡住，可手动清理故障事件，触发集群重新发起全量比对与同步：
# 清理指定单个DML事件，event_id从showdmlevent输出中获取
gcadmin rmdmlevent 事件ID
# 批量清理所有DML事件（多表异常时使用）
gcadmin rmdmlevent all清理后集群会以主副本中 SCN 号更高的分片为基准，自动向异常节点同步数据，期间可通过同步日志观察进度。
场景 3：反复不一致，执行一致性修复
如果清理事件后故障反复出现，可开启集群一致性自动修复功能（V862Build33+、V9.5 及以上版本支持）：
-- 全局开启自动一致性修复
SET GLOBAL gcluster_suffix_consistency_resolve = 1;也可手动指定基准 SCN 号执行分片回滚修复：
REVERT TABLE 库名.表名 SCN_NUMBER 基准SCN号;场景 4：极端双副本故障
如果某张表的主、备两个副本所在节点
DataState 均为 1，属于双副本故障，无法自动恢复：- 若数据可恢复：判断哪个副本的数据更完整，清理该节点的故障事件，让集群以它为基准同步到另一节点
- 若数据完全损坏：通过历史备份恢复对应表数据，或重建表后重新导入
- 若节点硬件永久故障：执行节点替换操作，用新节点重建所有分片数据
五、结果验证
处理完成后，执行以下命令确认故障完全恢复：
# 确认所有数据节点DataState变回0
gcadmin
# 确认三类故障事件均已清空
gcadmin showdmlevent
gcadmin showddlevent
gcadmin showdmlstorageevent
