MySQL 8.4 发行说明
innochecksum 打印 InnoDB 文件的校验和。此工具读取 InnoDB 表空间文件，计算每个页面的校验和，将计算出的校验和与存储的校验和进行比较，并报告不匹配，这表明页面已损坏。它最初是为在断电后加速验证表空间文件完整性而开发的，但也可以在文件复制后使用。由于校验和不匹配会导致 InnoDB 故意关闭正在运行的服务器，因此与等待生产服务器遇到损坏页面相比，使用此工具可能更可取。
innochecksum 无法用于服务器已打开的表空间文件。对于此类文件，您应使用 CHECK TABLE 检查表空间内的表。尝试在服务器已打开的表空间上运行 innochecksum 将导致 无法锁定文件 错误。
如果发现校验和不匹配，请从备份中恢复表空间，或者启动服务器并尝试使用 mysqldump 备份表空间内的表。
调用 innochecksum 如以下所示
innochecksum [options] file_nameinnochecksum 选项
innochecksum 支持以下选项。对于引用页面号的选项，页面号为从零开始的。
--help,-?命令行格式 --help类型 布尔值 默认值 false显示命令行帮助。示例用法
innochecksum --help--info,-I命令行格式 --info类型 布尔值 默认值 false是
--help的同义词。显示命令行帮助。示例用法innochecksum --info--version,-V命令行格式 --version类型 布尔值 默认值 false显示版本信息。示例用法
innochecksum --version--verbose,-v命令行格式 --verbose类型 布尔值 默认值 false详细模式；每五秒钟将进度指示器打印到日志文件。为了打印进度指示器，必须使用
--log option指定日志文件。要开启verbose模式，请运行innochecksum --verbose要关闭详细模式，请运行
innochecksum --verbose=FALSE--verbose选项和--log选项可以同时指定。例如innochecksum --verbose --log=/var/lib/mysql/test/logtest.txt要查找日志文件中的进度指示器信息，您可以执行以下搜索
cat ./logtest.txt | grep -i "okay"日志文件中的进度指示器信息类似于以下内容
page 1663 okay: 2.863% done page 8447 okay: 14.537% done page 13695 okay: 23.568% done page 18815 okay: 32.379% done page 23039 okay: 39.648% done page 28351 okay: 48.789% done page 33023 okay: 56.828% done page 37951 okay: 65.308% done page 44095 okay: 75.881% done page 49407 okay: 85.022% done page 54463 okay: 93.722% done ...--count,-c命令行格式 --count类型 基本名称 默认值 true打印文件中的页面数量并退出。示例用法
innochecksum --count ../data/test/tab1.ibd--start-page=,num-snum命令行格式 --start-page=#类型 数字 默认值 0从该页码开始。示例用法
innochecksum --start-page=600 ../data/test/tab1.ibd或者
innochecksum -s 600 ../data/test/tab1.ibd--end-page=,num-enum命令行格式 --end-page=#类型 数字 默认值 0最小值 0最大值 18446744073709551615在该页码结束。示例用法
innochecksum --end-page=700 ../data/test/tab1.ibd或者
innochecksum --p 700 ../data/test/tab1.ibd--page=,num-pnum命令行格式 --page=#类型 整数 默认值 0仅检查该页码。示例用法
innochecksum --page=701 ../data/test/tab1.ibd--strict-check,-C命令行格式 --strict-check=algorithm类型 枚举 默认值 crc32有效值 innodbcrc32none指定严格校验和算法。选项包括
innodb、crc32和none。在此示例中，指定了
innodb校验和算法innochecksum --strict-check=innodb ../data/test/tab1.ibd在此示例中，指定了
crc32校验和算法innochecksum -C crc32 ../data/test/tab1.ibd适用以下条件
如果您没有指定
--strict-check选项，则 innochecksum 会针对innodb、crc32和none进行验证。如果您指定了
none选项，则只允许none生成的校验和。如果您指定了
innodb选项，则只允许innodb生成的校验和。如果您指定了
crc32选项，则只允许crc32生成的校验和。
--no-check,-n命令行格式 --no-check类型 布尔值 默认值 false在重写校验和时忽略校验和验证。此选项只能与 innochecksum
--write选项一起使用。如果没有指定--write选项，则 innochecksum 将终止。在这个示例中，一个
innodb校验和被重写以替换一个无效的校验和。innochecksum --no-check --write innodb ../data/test/tab1.ibd-
命令行格式 --allow-mismatches=#类型 整数 默认值 0最小值 0最大值 18446744073709551615在 innochecksum 终止之前允许的最大校验和不匹配次数。默认设置是 0。如果
--allow-mismatches=N，其中N>=0N次不匹配，并且 innochecksum 在N+1--allow-mismatches设置为 0 时，innochecksum 在第一次校验和不匹配时终止。在这个示例中，一个现有的
innodb校验和被重写以将--allow-mismatches设置为 1。innochecksum --allow-mismatches=1 --write innodb ../data/test/tab1.ibd当
--allow-mismatches设置为 1 时，如果在一个包含 1000 页的文件中第 600 页和第 700 页出现不匹配，则会更新第 0-599 页和第 601-699 页的校验和。因为--allow-mismatches设置为 1，校验和容忍第一次不匹配，并在第二次不匹配时终止，使得第 600 页和第 700-999 页保持不变。 --write=,name-wnum命令行格式 --write=algorithm类型 枚举 默认值 crc32有效值 innodbcrc32none重写校验和。在重写无效校验和时，必须将
--no-check选项与--write选项一起使用。--no-check选项告诉 innochecksum 忽略对无效校验和的验证。如果当前校验和有效，则不必指定--no-check选项。使用
--write选项时，必须指定算法。--write选项的可能值有innodb: 使用来自InnoDB的原始算法以软件方式计算的校验和。crc32: 使用crc32算法计算的校验和，可能使用硬件辅助。none: 一个常数。
--write选项会将整个页面重写到磁盘上。如果新校验和与现有校验和相同，则不会将新校验和写入磁盘，以最大程度地减少 I/O 操作。当使用
--write选项时，innochecksum 会获取一个排他锁。在这个示例中，一个
crc32校验和被写入tab1.ibd。innochecksum -w crc32 ../data/test/tab1.ibd在这个示例中，一个
crc32校验和被重写以替换一个无效的crc32校验和。innochecksum --no-check --write crc32 ../data/test/tab1.ibd-
命令行格式 --page-type-summary类型 布尔值 默认值 false显示表空间中每种页面类型的计数。示例用法
innochecksum --page-type-summary ../data/test/tab1.ibd--page-type-summary的示例输出File::../data/test/tab1.ibd ================PAGE TYPE SUMMARY============== #PAGE_COUNT PAGE_TYPE =============================================== 2 Index page 0 Undo log page 1 Inode page 0 Insert buffer free list page 2 Freshly allocated page 1 Insert buffer bitmap 0 System page 0 Transaction system page 1 File Space Header 0 Extent descriptor page 0 BLOB page 0 Compressed BLOB page 0 Other type of page =============================================== Additional information: Undo page type: 0 insert, 0 update, 0 other Undo page state: 0 active, 0 cached, 0 to_free, 0 to_purge, 0 prepared, 0 other --page-type-dump,-D命令行格式 --page-type-dump=name类型 字符串 默认值 [无]将表空间中每页的页面类型信息转储到
stderr或stdout。示例用法innochecksum --page-type-dump=/tmp/a.txt ../data/test/tab1.ibd--log,-l命令行格式 --log=path类型 文件名 默认值 [无]innochecksum 工具的日志输出。必须提供日志文件名。日志输出包含每个表空间页面的校验和值。对于未压缩的表，还提供了 LSN 值。示例用法
innochecksum --log=/tmp/log.txt ../data/test/tab1.ibd或者
innochecksum -l /tmp/log.txt ../data/test/tab1.ibd指定
-选项从标准输入读取。如果在预期“从标准输入读取”时缺少 “-” 选项，innochecksum 会打印 innochecksum 的使用信息，指示 “-” 选项被省略。示例用法cat t1.ibd | innochecksum -在这个示例中，innochecksum 将
crc32校验和算法写入a.ibd，而不会更改原始的t1.ibd文件。cat t1.ibd | innochecksum --write=crc32 - > a.ibd
在多个用户定义的表空间文件上运行 innochecksum
以下示例演示如何在多个用户定义的表空间文件（.ibd 文件）上运行 innochecksum。
对 “test” 数据库中的所有表空间（.ibd）文件运行 innochecksum
innochecksum ./data/test/*.ibd对所有文件名以 “t” 开头的表空间文件（.ibd 文件）运行 innochecksum
innochecksum ./data/test/t*.ibd对 data 目录中的所有表空间文件（.ibd 文件）运行 innochecksum
innochecksum ./data/*/*.ibd注意
在 Windows 操作系统上不支持在多个用户定义的表空间文件上运行 innochecksum，因为 Windows shell（如 cmd.exe）不支持通配符模式扩展。在 Windows 系统上，必须针对每个用户定义的表空间文件单独运行 innochecksum。例如
innochecksum.exe t1.ibd
innochecksum.exe t2.ibd
innochecksum.exe t3.ibd在多个系统表空间文件上运行 innochecksum
默认情况下，只有一个 InnoDB 系统表空间文件（ibdata1），但可以使用 innodb_data_file_path 选项定义系统表空间的多个文件。在以下示例中，使用 innodb_data_file_path 选项定义了系统表空间的三个文件：ibdata1、ibdata2 和 ibdata3。
./bin/mysqld --no-defaults --innodb-data-file-path="ibdata1:10M;ibdata2:10M;ibdata3:10M:autoextend"这三个文件（ibdata1、ibdata2 和 ibdata3）构成一个逻辑系统表空间。要在构成一个逻辑系统表空间的多个文件上运行 innochecksum，innochecksum 需要 - 选项从标准输入读取表空间文件，这等效于连接多个文件以创建一个单一文件。对于上述示例，将使用以下 innochecksum 命令
cat ibdata* | innochecksum -有关 “-” 选项的更多信息，请参阅 innochecksum 选项信息。
注意
在 Windows 操作系统上不支持在同一个表空间中的多个文件上运行 innochecksum，因为 Windows shell（如 cmd.exe）不支持通配符模式扩展。在 Windows 系统上，必须针对每个系统表空间文件单独运行 innochecksum。例如
innochecksum.exe ibdata1
innochecksum.exe ibdata2
innochecksum.exe ibdata3