pg_waldump#
pg_waldump
pg_waldump — отображает человекочитаемое представление журнала предварительной записи кластера базы данных Tantor SE
Синтаксис
pg_waldump [option...] [startseg [endseg]]
Описание
pg_waldump отображает журнал предварительной записи (WAL) и в основном
полезен для отладки или образовательных целей.
Эта утилита можно запустить только пользователем, который установил сервер, поскольку она требует только чтения каталога данных.
Опции
Следующие параметры командной строки управляют местоположением и форматом вывода:
startsegНачните чтение с указанного файла сегмента журнала. Это неявно определяет путь, в котором будут искаться файлы, и временную линию для использования.
endsegОстановиться после прочтения указанного файла сегмента журнала.
-b--bkp-detailsВывод подробной информации о резервных блоках.
-Bblock--block=blockОтобразить только записи, которые изменяют заданный блок. Также необходимо указать отношение с помощью
--relationили-R.-eend--end=endОстановить чтение в указанной позиции WAL, вместо чтения до конца потока журнала.
-f--followПосле достижения конца действительного WAL продолжайте опрашивать каждую секунду на наличие нового WAL.
-Ffork--fork=forkЕсли указано, отображаются только записи, которые изменяют блоки в указанного форка. Допустимые значения:
mainдля основного форка,fsmдля карты свободного пространства,vmдля карты видимости, иinitдля форка инициализации.-nlimit--limit=limitОтобразить указанное количество записей, а затем остановиться.
-ppath--path=pathУказывает каталог для поиска файлов сегментов журнала или каталог с подкаталогом
pg_wal, содержащим такие файлы. По умолчанию производится поиск в текущем каталоге, в подкаталогеpg_walтекущего каталога и в подкаталогеpg_walPGDATA.-q--quietНе выводить никакого вывода, за исключением ошибок. Этот параметр может быть полезен, когда нужно узнать, может ли определенный диапазон записей WAL быть успешно разобран, но вам не важно содержимое записей.
-rrmgr--rmgr=rmgrОтобразить только записи, сгенерированные указанным менеджером ресурсов. Вы можете указать эту опцию несколько раз, чтобы выбрать несколько менеджеров ресурсов. Если в качестве имени передано значение
list, выведите список допустимых имен менеджеров ресурсов и завершите работу.Расширения могут определять пользовательские менеджеры ресурсов, но pg_waldump не загружает модуль расширения и, следовательно, не распознает пользовательские менеджеры ресурсов по имени. Вместо этого вы можете указать пользовательские менеджеры ресурсов как
custom###, где "###" - это трехзначный идентификатор менеджера ресурсов. Имена такого вида всегда будут считаться допустимыми.-Rtblspc/db/rel--relation=tblspc/db/relОтображать только записи, которые изменяют блоки в указанного отношения. Отношение указывается с помощью идентификатора таблицы, идентификатора базы данных и идентификатора файла отношения, разделенных косыми чертами, например
1234/12345/12345. Это тот же формат, который используется для отношений в выводе программы.-sstart--start=startМестоположение WAL, с которого начать чтение. По умолчанию начинается чтение первой допустимой записи журнала, найденной в самом раннем файле.
-ttimeline--timeline=timelineВременная шкала, из которой считываются журнальные записи. По умолчанию используется значение в
startseg, если оно указано; в противном случае, значение по умолчанию равно 1.-V--versionВыведите версию pg_waldump и завершите работу.
-w--fullpageОтобразить только записи, которые содержат полностраничные изображения.
-xxid--xid=xidОтобразить только записи, помеченные данным идентификатором транзакции.
-z--stats[=record]Отображение сводной статистики (количества и размера записей и полностраничных изображений) вместо отдельных записей. При необходимости можно генерировать статистику для каждой записи вместо каждого регионального менеджера.
Если pg_waldump завершается сигналом SIGINT (Control+C), то выводится сводка вычисленной статистики до точки завершения. Эта операция не поддерживается в Windows.
-?--helpПоказать справку о командной строке аргументов pg_waldump и выйти.
Окружение
PGDATAКаталог данных; см. также опцию
-p.PG_COLORОпределяет, следует ли использовать цвет в диагностических сообщениях. Возможные значения:
always,autoиnever.
Примечания
Может давать неправильные результаты при работе сервера.
Отображается только указанная временная шкала (или используется значение по умолчанию, если не указано ни одной). Записи в других временных шкалах игнорируются.
pg_waldump не может читать WAL-файлы с суффиксом
.partial. Если эти файлы нужно прочитать, суффикс
.partial должен быть удален из имени файла.