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