介绍
innochecksum打印InnoDB文件的校验和。此工具读取InnoDB表空间文件,计算每个页面的校验和,将计算的校验和与存储的校验和进行比较,并报告不匹配,这表明页面已损坏。它最初是为了在停电后加快验证表空间文件的完整性而开发的,但也可以在文件复制后使用。由于校验和不匹配导致InnoDB故意关闭正在运行的服务器,因此最好使用此工具而不是等待生产中的服务器遇到损坏的页面。
innochecksum不能用于服务器已打开的表空间文件。对于此类文件,应使用CHECK TABLE检查表空间中的表。尝试在服务器已打开的表空间上运行innochecksum将导致“Unable to lock file”错误。
如果找到校验和不匹配,通常会从备份恢复表空间或启动服务器并尝试使用mysqldump对表空间中的表进行备份。
参数
- --count , -c
打印文件中页数的计数并退出。 - --start-page=num , -s num
从此页码开始。 - --end-page=num , -e num
在此页码结束。 - --page=num , -p num
仅检查此页码。 - --strict-check , -C
指定严格的校验和算法。选项包括 innodb,crc32 和 none 。
如果未指定 --strict-check 选项, innochecksum 将对 innodb , crc32 和 none 进行验证。
如果指定 none 选项,则仅允许 none 生成的校验和。
如果指定 innodb 选项,则仅允许 innodb 生成的校验和。
如果指定 crc32 选项,则仅指定校验和由 crc32 生成是允许的。
- --no-check , -n
重写校验和时忽略校验和验证。此选项仅可与 innochecksum --write 选项一起使用。如果未指定 --write 选项,则 innochecksum 将终止。 - --allow-mismatches , -a
在 innochecksum 终止之前允许的最大校验和不匹配数。默认设置为0.如果 --allow-mismatches= N ,其中允许 N>=0 , N 不匹配且 innochecksum 在 N+1 处终止。当 --allow-mismatches 设置为0时, innochecksum 在第一个校验和不匹配时终止。 - --write=name , -w num
重写校验和。重写无效校验和时, --no-check 选项必须与 --write 选项一起使用。 --no-check 选项告诉 innochecksum 忽略无效校验和的验证。如果当前校验和有效,则不必指定 --no-check 选项。
使用 --write 选项时必须指定算法。使用 --write 选项时获得独占锁,--write 选项的可能值为:
* innodb :使用 InnoDB 中的原始算法在软件中计算的校验和。
* crc32 :使用 crc32 算法计算的校验和,可能使用硬件辅助。
* none :一个常数。
--write 选项将整个页面重写为磁盘。如果新校验和与现有校验和相同,则新校验和不会写入磁盘以最小化I / O.
- --page-type-summary , -S
--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
将表空间中每个页面的页面类型信息转储到 stderr 或 stdout 。 - --log , -l
- 工具的日志输出。必须提供日志文件名。日志输出包含每个表空间页面的校验和值。对于未压缩的表,还提供了LSN值。 --log 替换了早期版本中提供的 --debug 选项。
- - 选项。
指定 - 选项以从标准输入读取。如果在预期“从标准读取”时缺少 - 选项, innochecksum 将输出 innochecksum 用法信息,指示省略了“ - ”选项。
用法
shell> innochecksum [options] file_name
在多个用户定义的表空间文件( .ibd 文件)上运行
对“test”数据库中的所有表空间( .ibd )文件运行 innochecksum :
shell> innochecksum ./data/test/*.ibd
对于文件名以“t”开头的所有表空间文件( .ibd 文件)运行 innochecksum :
shell> innochecksum ./data/test/t*.ibd
对 data 目录中的所有表空间文件( .ibd 文件)运行 innochecksum :
shell> innochecksum ./data/*/*.ibd
在多个系统表空间文件上运行innochecksum
默认情况下,只有一个 InnoDB 系统表空间文件( ibdata1 ),但可以使用 innodb_data_file_path 选项定义系统表空间的多个文件。在以下示例中,使用 innodb_data_file_path 选项定义系统表空间的三个文件: ibdata1 , ibdata2 和 ibdata3 。
shell> ./bin/mysqld --no-defaults --innodb-data-file-path="ibdata1:10M;ibdata2:10M;ibdata3:10M:autoextend"
这三个文件( ibdata1 , ibdata2 和 ibdata3 )构成一个逻辑系统表空间。要在形成一个逻辑系统表空间的多个文件上运行 innochecksum , innochecksum 需要 - 选项从标准输入读取表空间文件,这相当于连接多个文件以创建一个文件。对于上面提供的示例,以下 innochecksum 将使用命令:
shell> cat ibdata* | innochecksum -