pg_checksums
pg_checksums — включить, отключить или проверить контрольные суммы данных в кластере Postgres Pro
Синтаксис
pg_checksums [параметр...] [[ -D | --pgdata ]каталог_данных]
Описание #
Утилита pg_checksums позволяет проверить, включить или отключить контрольные суммы данных в кластере Postgres Pro. Перед запуском pg_checksums сервер должен быть остановлен в штатном режиме. При проверке контрольных сумм она возвращает нулевой код состояния, если ошибок не найдено, либо ненулевой код, если обнаружится хотя бы одна ошибка. При включении или отключении контрольных сумм ненулевой код завершения показывает, что выполнить операцию не удалось.
В процессе проверки контрольных сумм проверяется каждый файл в кластере. При включении контрольных сумм для каждого блока файлов отношений рассчитывается контрольная сумма и он перезаписывается на месте, а при отключении изменяется только файл pg_control.
Параметры
Принимаются следующие параметры командной строки:
-Dкаталог--pgdata=каталогУказывает каталог, в котором располагается кластер баз данных.
-c--checkЗапускает проверку контрольных сумм. Это режим по умолчанию, который выбирается, когда не указан никакой другой.
-d--disableОтключает контрольные суммы.
-e--enableВключает контрольные суммы.
-fфайловый_узел--filenode=файловый_узелПроверять контрольные суммы только в отношении, которому соответствует указанный
файловый_узел.-N--no-syncПо умолчанию
pg_checksumsждёт, пока все файлы не будут надёжно записаны на диск. С данным параметромpg_checksumsзавершается быстрее, без ожидания, но в случае неожиданного сбоя операционной системы каталог с изменёнными файлами может повредиться. Этот параметр может быть полезен при тестировании; в производственной среде применять его не следует. В режиме--checkон не оказывает никакого влияния.-P--progressВключает вывод сообщений о прогрессе. Эти сообщения будут выводиться при проверке или включении контрольных сумм.
-v--verboseВыводить подробные сообщения, в частности список всех проверенных файлов.
-V--versionВыводит версию pg_checksums и завершает работу.
-?--helpПоказывает справку по аргументам командной строки pg_checksums и завершает работу.
Переменные окружения
PGDATAУказывает каталог, в котором располагается кластер баз данных; может переопределяться параметром
-D.PG_COLORВыбирает вариант использования цвета в диагностических сообщениях. Возможные значения:
always(всегда),auto(автоматически) иnever(никогда).
Примечания
Включение контрольных сумм в большом кластере может занять продолжительное время. Пока эта операция не закончится, нельзя запускать сервер или другие программы, которые могут произвести запись в каталог данных, иначе возможна потеря данных.
В конфигурациях, где организована репликация, и она осуществляется путём непосредственного копирования блоков отношений на уровне файлов (например, с помощью pg_rewind), включение или отключение контрольных сумм может привести к повреждению страниц (а именно, расхождению контрольных сумм), если эта операция не будет выполнена согласованно на всех узлах. Поэтому в подобных конфигурациях рекомендуется остановить все кластеры, с тем чтобы одновременно переключить их в другой режим. Ещё один безопасный вариант — ликвидировать все ведомые серверы, произвести нужную операцию на ведущем, а затем создать ведомые серверы заново.
Если pg_checksums прерывается или работающий процесс уничтожается при включении или отключении контрольных сумм, конфигурация контрольных сумм в кластере остаётся неизменной, и pg_checksums можно перезапустить ещё раз для повторения невыполненной операции.
pg_checksums
pg_checksums — enable, disable or check data checksums in a Postgres Pro database cluster
Synopsis
pg_checksums [option...] [[ -D | --pgdata ]datadir]
Description #
pg_checksums checks, enables or disables data checksums in a Postgres Pro cluster. The server must be shut down cleanly before running pg_checksums. When verifying checksums, the exit status is zero if there are no checksum errors, and nonzero if at least one checksum failure is detected. When enabling or disabling checksums, the exit status is nonzero if the operation failed.
When verifying checksums, every file in the cluster is scanned. When enabling checksums, each relation file block with a changed checksum is rewritten in-place. Disabling checksums only updates the file pg_control.
Options
The following command-line options are available:
-Ddirectory--pgdata=directorySpecifies the directory where the database cluster is stored.
-c--checkChecks checksums. This is the default mode if nothing else is specified.
-d--disableDisables checksums.
-e--enableEnables checksums.
-ffilenode--filenode=filenodeOnly validate checksums in the relation with filenode
filenode.-N--no-syncBy default,
pg_checksumswill wait for all files to be written safely to disk. This option causespg_checksumsto return without waiting, which is faster, but means that a subsequent operating system crash can leave the updated data directory corrupt. Generally, this option is useful for testing but should not be used on a production installation. This option has no effect when using--check.-P--progressEnable progress reporting. Turning this on will deliver a progress report while checking or enabling checksums.
-v--verboseEnable verbose output. Lists all checked files.
-V--versionPrint the pg_checksums version and exit.
-?--helpShow help about pg_checksums command line arguments, and exit.
Environment
PGDATASpecifies the directory where the database cluster is stored; can be overridden using the
-Doption.PG_COLORSpecifies whether to use color in diagnostic messages. Possible values are
always,autoandnever.
Notes
Enabling checksums in a large cluster can potentially take a long time. During this operation, the cluster or other programs that write to the data directory must not be started or else data loss may occur.
When using a replication setup with tools which perform direct copies of relation file blocks (for example pg_rewind), enabling or disabling checksums can lead to page corruptions in the shape of incorrect checksums if the operation is not done consistently across all nodes. When enabling or disabling checksums in a replication setup, it is thus recommended to stop all the clusters before switching them all consistently. Destroying all standbys, performing the operation on the primary and finally recreating the standbys from scratch is also safe.
If pg_checksums is aborted or killed while enabling or disabling checksums, the cluster's data checksum configuration remains unchanged, and pg_checksums can be re-run to perform the same operation.