6.6.2 innochecksum — Offline InnoDB File Checksum Utility — MySQL 8.4

6.6.2 innochecksum — Утилита проверки контрольных сумм файлов InnoDB (оффлайн)

innochecksum вычисляет контрольные суммы для InnoDB файлов. Этот инструмент считывает файл табличного пространства InnoDB, вычисляет контрольную сумму для каждой страницы, сравнивает вычисленную контрольную сумму с хранимой контрольной суммой и сообщает о несоответствиях, которые указывают на поврежденные страницы. Эта утилита была первоначально разработана для ускорения проверки целостности файлов табличного пространства после отключения питания, но также может использоваться после копирования файлов. Поскольку несоответствия контрольных сумм приводят к InnoDB преднамеренному завершению работы сервера, использование этого инструмента может быть предпочтительнее, чем ожидание, пока поврежденные страницы не будут обнаружены работающим сервером.

innochecksum нельзя использовать для файлов табличного пространства, которые уже открыты сервером. Для таких файлов следует использовать CHECK TABLE для проверки таблиц в табличном пространстве. Попытка запустить innochecksum на табличном пространстве, которое уже открыто сервером, приводит к ошибке Не удалось заблокировать файл.

Если обнаружены несоответствия контрольных сумм, восстановите табличное пространство из резервной копии или запустите сервер и попробуйте использовать mysqldump для создания резервной копии таблиц в табличном пространстве.

Вызов innochecksum выполняется так:

innochecksum [options] file_name

Параметры innochecksum

innochecksum поддерживает следующие параметры. Для параметров, которые относятся к номерам страниц, номера являются нуль-основанными.

--help, -?

Формат командной строки --help

Тип Boolean

Значение по умолчанию false

Отображает справку по командной строке. Пример использования:
```
innochecksum --help
```
--info, -I

Формат командной строки --info

Тип Boolean

Значение по умолчанию false

Синоним для --help. Отображает справку по командной строке. Пример использования:
```
innochecksum --info
```
--version, -V

Формат командной строки --version

Тип Boolean

Значение по умолчанию false

Отображает информацию о версии. Пример использования:
```
innochecksum --version
```
--verbose, -v

Формат командной строки --verbose

Тип Boolean

Значение по умолчанию 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

Тип Base name

Значение по умолчанию true

Вывести количество страниц в файле и завершить работу. Пример использования:
```
innochecksum --count ../data/test/tab1.ibd
```
--start-page=num, -s num

Формат командной строки --start-page=#

Тип Numeric

Значение по умолчанию 0

Начать с этого номера страницы. Пример использования:
```
innochecksum --start-page=600 ../data/test/tab1.ibd
```
или:
```
innochecksum -s 600 ../data/test/tab1.ibd
```

Формат командной строки	`--help`
Тип	Boolean
Значение по умолчанию	`false`

Формат командной строки	`--info`
Тип	Boolean
Значение по умолчанию	`false`

Формат командной строки	`--version`
Тип	Boolean
Значение по умолчанию	`false`

Формат командной строки	`--verbose`
Тип	Boolean
Значение по умолчанию	`false`

Формат командной строки	`--count`
Тип	Base name
Значение по умолчанию	`true`

Формат командной строки	`--start-page=#`
Тип	Numeric
Значение по умолчанию	`0`

--end-page=num, -e num

Формат командной строки	`--end-page=#`
Тип	Numeric
Значение по умолчанию	`0`
Минимальное значение	`0`
Максимальное значение	`18446744073709551615`

Завершить на этом номере страницы. Пример использования:

innochecksum --end-page=700 ../data/test/tab1.ibd

или:

innochecksum --p 700 ../data/test/tab1.ibd

--page=num, -p num

Формат командной строки --page=#

Тип Integer

Значение по умолчанию 0

Проверить только этот номер страницы. Пример использования:
```
innochecksum --page=701 ../data/test/tab1.ibd
```

Формат командной строки	`--page=#`
Тип	Integer
Значение по умолчанию	`0`

--strict-check, -C

Формат командной строки	`--strict-check=algorithm`
Тип	Enumeration
Значение по умолчанию	`crc32`
Допустимые значения	`innodb` `crc32` `none`

Укажите строгий алгоритм контрольной суммы. Доступные варианты: 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

Тип Boolean

Значение по умолчанию false

Игнорировать проверку контрольной суммы при перезаписи контрольной суммы. Этот параметр может использоваться только с параметром innochecksum --write. Если параметр --write не указан, innochecksum завершает работу.

В этом примере контрольная сумма innodb перезаписывается для замены неверной контрольной суммы:
```
innochecksum --no-check --write innodb ../data/test/tab1.ibd
```

Формат командной строки	`--no-check`
Тип	Boolean
Значение по умолчанию	`false`

--allow-mismatches, -a

Формат командной строки	`--allow-mismatches=#`
Тип	Целое число
Значение по умолчанию	`0`
Минимальное значение	`0`
Максимальное значение	`18446744073709551615`

Максимальное количество несоответствий контрольной суммы, разрешённых до завершения innochecksum. Значение по умолчанию — 0. Если --allow-mismatches=N, где N>=0, допускается N несоответствий, и innochecksum завершается на N+1. Когда --allow-mismatches установлено в 0, innochecksum завершается при первом несоответствии контрольной суммы.

В этом примере существующая innodb контрольная сумма переписывается, чтобы установить --allow-mismatches в 1.

innochecksum --allow-mismatches=1 --write innodb ../data/test/tab1.ibd

При установке --allow-mismatches в 1, если есть несоответствие на странице 600 и ещё одно на странице 700 в файле с 1000 страницами, контрольная сумма обновляется для страниц с 0 до 599 и с 601 до 699. Поскольку --allow-mismatches установлено в 1, контрольная сумма терпит первое несоответствие и завершается на втором несоответствии, оставив страницу 600 и страницы с 700 по 999 без изменений.

--write=name, -w num

Формат командной строки	`--write=algorithm`
Тип	Перечисление
Значение по умолчанию	`crc32`
Допустимые значения	`innodb` `crc32` `none`

Переписать контрольную сумму. При переписывании недействительной контрольной суммы опция --no-check должна использоваться вместе с опцией --write. Опция --no-check сообщает innochecksum проигнорировать проверку недействительной контрольной суммы. Вам не нужно указывать опцию --no-check, если текущая контрольная сумма действительна.

Алгоритм должен быть указан при использовании опции --write. Возможные значения для опции --write:

innodb: Расчёт контрольной суммы в программном обеспечении, используя оригинальный алгоритм из InnoDB.
crc32: Расчёт контрольной суммы с помощью алгоритма crc32, возможно, с помощью аппаратной поддержки.
none: Постоянное число.

Опция --write переписывает целые страницы на диск. Если новая контрольная сумма идентична существующей контрольной сумме, новая контрольная сумма не записывается на диск, чтобы минимизировать ввод-вывод.

innochecksum получает эксклюзивную блокировку, когда используется опция --write.

В этом примере записывается crc32 контрольная сумма для tab1.ibd:

innochecksum -w crc32 ../data/test/tab1.ibd

В этом примере crc32 контрольная сумма переписывается, чтобы заменить недействительную crc32 контрольную сумму:

innochecksum --no-check --write crc32 ../data/test/tab1.ibd

--page-type-summary, -S

Формат командной строки	`--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

Тип Строка

Значение по умолчанию [none]

Вывести информацию о типе страницы для каждой страницы в табличном пространстве в stderr или stdout. Пример использования:
```
innochecksum --page-type-dump=/tmp/a.txt ../data/test/tab1.ibd
```
--log, -l

Формат командной строки --log=path

Тип Имя файла

Значение по умолчанию [none]

Лог вывода для инструмента 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
```

Формат командной строки	`--page-type-dump=name`
Тип	Строка
Значение по умолчанию	`[none]`

Формат командной строки	`--log=path`
Тип	Имя файла
Значение по умолчанию	`[none]`

Запуск innochecksum для нескольких файлов пользовательского табличного пространства

Следующие примеры демонстрируют, как запустить innochecksum для нескольких файлов пользовательского табличного пространства (файлы .ibd).

Запуск innochecksum для всех файлов табличного пространства (.ibd) в базе данных “test”:

innochecksum ./data/test/*.ibd

Запуск innochecksum для всех файлов табличного пространства (файлов .ibd), у которых имя файла начинается с “t”:

innochecksum ./data/test/t*.ibd

Запуск innochecksum для всех файлов табличного пространства (файлов .ibd) в каталоге data:

innochecksum ./data/*/*.ibd

Примечание

Запуск innochecksum для нескольких файлов пользовательского табличного пространства не поддерживается в операционных системах Windows, так как оболочки Windows, такие как cmd.exe, не поддерживают расширение шаблонов glob. В системах 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.

Примечание

Запуск innochecksum на нескольких файлах в одном табличном пространстве не поддерживается в операционных системах Windows, так как оболочки Windows, такие как cmd.exe, не поддерживают расширение шаблонов подстановок. В системах Windows innochecksum необходимо запускать отдельно для каждого файла системного табличного пространства. Например:

innochecksum.exe ibdata1
innochecksum.exe ibdata2
innochecksum.exe ibdata3