pg_checksums#

pg_checksums

pg_checksums

pg_checksums — включение, отключение или проверка контрольных сумм данных в кластере базы данных Tantor SE

Синтаксис

pg_checksums [опция...] [[ -D | --pgdata ]datadir]

Описание

pg_checksums проверяет, включает или отключает контрольные суммы данных в кластере Tantor SE. Сервер должен быть корректно остановлен перед запуском pg_checksums. При проверке контрольных сумм, код возврата равен нулю, если ошибок контрольных сумм не обнаружено, и ненулевой, если обнаружена хотя бы одна ошибка контрольной суммы. При включении или отключении контрольных сумм, код возврата ненулевой, если операция не удалась.

При проверке контрольных сумм сканируется каждый файл в кластере. При включении контрольных сумм каждый блок файла отношения с измененной контрольной суммой перезаписывается на месте. Отключение контрольных сумм обновляет только файл pg_control.

Опции

Доступны следующие параметры командной строки:

-D directory
--pgdata=directory

Определяет каталог, в котором хранится кластер базы данных.

-c
--check

Проверяет контрольные суммы. Это режим по умолчанию, если ничего другого не указано.

-d
--disable

Отключает контрольные суммы.

-e
--enable

Включает контрольные суммы.

-f filenode
--filenode=filenode

Только проверьте контрольные суммы в отношении с файловым узлом 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 может быть повторно запущен для выполнения той же операции.