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