金仓数据库KingbaseES服务器应用参考手册--4. sys_checksums

4.1. 简介：

sys_checksums— 启用、禁用或检查KingbaseES数据库集簇中的数据校验和。

sys_checksums检查、启用或禁用KingbaseES集簇中的数据校验和。服务器必须在运行 sys_checksums之前完全地关闭。在验证校验和时，如果没有校验和错误，则退出状态为零;如果检测到至少一个校验和失败，则退出状态为非零。

启用或禁用校验和时，如果操作失败，则退出状态为非零。

在验证校验和时，将扫描集簇中的每个文件。启用校验和时，将重写集簇中的每个文件。禁用校验和只更新文件sys_control。

4.2. 命令行参数：

sys_checksums [option...] [[ -D | --kingbase-data ] datadir]

4.3. 参数说明：

可以使用以下命令行选项:

-D directory

--kingbase-data=directory

指定存储数据库集簇的目录。

-c

--check

检查校验和。如果没有指定其他内容，这就是默认模式。

-d

--disable

禁用校验和。

-e

--enable

启用校验和。

-f filenode

--filenode=filenode

只验证文件名与 filenode 参数值有关的校验和

-N

--no-sync

默认情况下，sys_checksums将等待所有文件安全写入磁盘。这个选项会导致sys_checksums不需要等待就返回，这样会更快，但是这意味着后续的操作系统崩溃会导致更新后的数据目录损坏。通常，此选项对测试有用，但不应用于生产安装。当使用--check时，此选项无效。

-P

--progress

启动进展报告。打开此选项将在检查或启用校验和时提交进度报告。

-v

--verbose

启用详细输出。列出所有已检查的文件。

-V

--version

打印 sys_checksums的版本并退出。

-?

--help

显示关于sys_checksums命令行参数的帮助，并退出。

4.4. 环境变量：

KINGBASE_DATA

指定数据库集簇存储的目录;可以使用-D选项覆盖。

SYS_COLOR

指定是否在诊断消息中使用颜色。可能的值是always, auto, never.

4.5. 错误信息诊断：

无

4.6. 备注：

在大型集簇中启用校验和可能需要很长时间。在此操作期间，不能启动写入数据目录的集簇或其他程序，否则可能会发生数据丢失。

当使用直接复制关系文件块的工具(例如 sys_rewind )进行复制设置时，如果操作没有在所有节点上一致完成，启用或禁用校验和可能导致错误校验和的页面损坏。

因此，在复制设置中启用或禁用校验和时，建议在一致地切换所有集簇之前停止所有集簇。销毁所有备用服务器、在主服务器上执行操作并最终从头创建备用服务器也是安全的。

如果sys_checksums在完成执行启用或禁用校验和之前被终止，则集簇的数据校验和配置保持不变，并且sys_checksums可以重新运行以执行相同的操作。

4.7. 参考：

无