pg_checksums
pg_checksums — включить, отключить или проверить контрольные суммы данных в кластере PostgreSQL
Синтаксис
pg_checksums [параметр...] [[ -D | --pgdata ]каталог_данных]
Описание
Утилита pg_checksums позволяет проверить, включить или отключить контрольные суммы данных в кластере PostgreSQL. Перед запуском pg_checksums сервер должен быть остановлен в штатном режиме. При проверке контрольных сумм она возвращает нулевой код состояния, если ошибок не найдено, либо ненулевой код, если обнаружится хотя бы одна ошибка. При включении или отключении контрольных сумм ненулевой код завершения показывает, что выполнить операцию не удалось.
В процессе проверки контрольных сумм проверяется каждый файл в кластере. При включении контрольных сумм для каждого блока файлов отношений рассчитывается контрольная сумма и он перезаписывается на месте, а при отключении изменяется только файл pg_control.
Параметры
Принимаются следующие параметры командной строки:
-Dкаталог--pgdata=каталогУказывает каталог, в котором располагается кластер баз данных.
-c--checkЗапускает проверку контрольных сумм. Это режим по умолчанию, который выбирается, когда не указан никакой другой.
-d--disableОтключает контрольные суммы.
-e--enableВключает контрольные суммы.
-fфайловый_узел--filenode=файловый_узелПроверять контрольные суммы только в отношении, которому соответствует указанный
файловый_узел.-N--no-syncПо умолчанию
pg_checksumsждёт, пока все файлы не будут надёжно записаны на диск. С данным параметромpg_checksumsзавершается быстрее, без ожидания, но в случае неожиданного сбоя операционной системы каталог с изменёнными файлами может повредиться. Этот параметр может быть полезен при тестировании; в производственной среде применять его не следует. В режиме--checkон не оказывает никакого влияния.-P--progressВключает вывод сообщений о прогрессе. Эти сообщения будут выводиться при проверке или включении контрольных сумм.
--sync-method=методСо значением
fsync(это значение по умолчанию),pg_checksumsбудет рекурсивно открывать и синхронизировать все файлы в каталоге данных. Поиск файлов будет осуществляться по символическим ссылкам для каталога WAL и каждого настроенного табличного пространства.В Linux возможен вариант
syncfs, когда от ОС требуется синхронизировать целиком каждую из файловых систем, содержащих каталог данных, файлы WAL и табличные пространства. Более подробно особенности использованияsyncfsописаны в recovery_init_sync_method.В режиме
--no-syncэтот параметр не оказывает никакого влияния.-v--verboseВыводить подробные сообщения, в частности список всех проверенных файлов.
-V--versionВыводит версию pg_checksums и завершает работу.
-?--helpПоказывает справку по аргументам командной строки pg_checksums и завершает работу.
Переменные окружения
PGDATAУказывает каталог, в котором располагается кластер баз данных; может переопределяться параметром
-D.PG_COLORВыбирает вариант использования цвета в диагностических сообщениях. Возможные значения:
always(всегда),auto(автоматически) иnever(никогда).
Примечания
Включение контрольных сумм в большом кластере может занять продолжительное время. Пока эта операция не закончится, нельзя запускать сервер или другие программы, которые могут произвести запись в каталог данных, иначе возможна потеря данных.
В конфигурациях, где организована репликация, и она осуществляется путём непосредственного копирования блоков отношений на уровне файлов (например, с помощью pg_rewind), включение или отключение контрольных сумм может привести к повреждению страниц (а именно, расхождению контрольных сумм), если эта операция не будет выполнена согласованно на всех узлах. Поэтому в подобных конфигурациях рекомендуется остановить все кластеры, с тем чтобы одновременно переключить их в другой режим. Ещё один безопасный вариант — ликвидировать все ведомые серверы, произвести нужную операцию на ведущем, а затем создать ведомые серверы заново.
Если pg_checksums прерывается или работающий процесс уничтожается при включении или отключении контрольных сумм, конфигурация контрольных сумм в кластере остаётся неизменной, и pg_checksums можно перезапустить ещё раз для повторения невыполненной операции.