checksum error ret=-4103

适用版本

OceanBase 数据库所有版本。

什么是 checksum

• data checksum：一个 SSTable 中所有宏块内存二进制计算出来的 checksum 值。反映了宏块中的数据和数据分布情况。如果宏块中数据一致但是数据分布不一致，计算出来的 checksum 也不相等。

• column checksum：SSTable 中所有行中相同列计算出来的 checksum 值，假设这个表共有 3 列，则会有 3 个 column checksum 值与每个列对应。

checksum 什么时候校验

在合并之后，Root Service 会进行 checksum 校验，主要校验两种情况。

• 副本间 data checksum：校验一个分区多个副本，相同 snapshot 的 Major SSTable 的 data checksum，应该相等。

• 主表索引表 column checksum：校验主表和索引表，相同 snapshot 的 Major SSTable，相同列的 column checksum，应该相等。

如果任一分区出现了 checksum 不一致的情况，就会报错 CHECKSUM ERROR。

CHECKSUM ERROR 如何排查

• 如何判断是否出现了 checksum error。

  • OceanBase 数据库 V1.x、V2.x、V3.x 版本。

    obclient> select * from __all_zone;   // 看 merge_status 列
    

  • OceanBase 数据库 V4.x 版本。

    obclient> select * from CDB_OB_MAJOR_COMPACTION;   // 看 IS_ERROR 列和 INFO 列
    

• 查看具体哪个分区出现了 checksum error。

  obclient> select * from CDB_OB_TABLET_CHECKSUM_ERROR_INFO;
  obclient> select * from CDB_OB_COLUMN_CHECKSUM_ERROR_INFO;
  

确认问题并联系 OceanBase 技术支持协助处理。