pg_waldump#

pg_waldump

pg_waldump

pg_waldump — отображает человекочитаемое представление журнала предварительной записи кластера базы данных Tantor BE

Синтаксис

pg_waldump [option...] [startseg [endseg]]

Описание

pg_waldump отображает журнал предварительной записи (WAL) и в основном полезен для отладки или образовательных целей.

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

Опции

Следующие параметры командной строки управляют местоположением и форматом вывода:

startseg

Начните чтение с указанного файла сегмента WAL. Это неявно определяет путь, в котором будут искаться файлы, и временную шкалу для использования.

endseg

Остановитесь после чтения указанного файла сегмента WAL.

-b
--bkp-details

Вывод подробной информации о резервных блоках.

-B block
--block=block

Отобразить только записи, которые изменяют заданный блок. Также необходимо указать отношение с помощью --relation или -R.

-e end
--end=end

Остановить чтение в указанной позиции WAL, вместо чтения до конца потока журнала.

-f
--follow

После достижения конца действительного WAL продолжайте опрашивать каждую секунду на наличие нового WAL.

-F fork
--fork=fork

Если указано, отображаются только записи, которые изменяют блоки в указанного форка. Допустимые значения: main для основного форка, fsm для карты свободного пространства, vm для карты видимости, и init для форка инициализации.

-n limit
--limit=limit

Отобразить указанное количество записей, а затем остановиться.

-p path
--path=path

Указывает каталог для поиска файлов сегментов WAL или каталог с подкаталогом pg_wal, содержащим такие файлы. По умолчанию поиск осуществляется в текущем каталоге, подкаталоге pg_wal текущего каталога и подкаталоге pg_wal PGDATA.

-q
--quiet

Не выводить никакого вывода, за исключением ошибок. Этот параметр может быть полезен, когда нужно узнать, может ли определенный диапазон записей WAL быть успешно разобран, но вам не важно содержимое записей.

-r rmgr
--rmgr=rmgr

Отобразить только записи, сгенерированные указанным менеджером ресурсов. Вы можете указать эту опцию несколько раз, чтобы выбрать несколько менеджеров ресурсов. Если в качестве имени передано значение list, выведите список допустимых имен менеджеров ресурсов и завершите работу.

Расширения могут определять пользовательские менеджеры ресурсов, но pg_waldump не загружает модуль расширения и, следовательно, не распознает пользовательские менеджеры ресурсов по имени. Вместо этого вы можете указать пользовательские менеджеры ресурсов как custom###, где "###" - это трехзначный идентификатор менеджера ресурсов. Имена такого вида всегда будут считаться допустимыми.

-R tblspc/db/rel
--relation=tblspc/db/rel

Отображать только записи, которые изменяют блоки в указанного отношения. Отношение указывается с помощью идентификатора таблицы, идентификатора базы данных и идентификатора файла отношения, разделенных косыми чертами, например 1234/12345/12345. Это тот же формат, который используется для отношений в выводе программы.

-s start
--start=start

Местоположение WAL, с которого начинается чтение. По умолчанию чтение начинается с первой допустимой записи WAL, найденной в самом раннем файле.

-t timeline
--timeline=timeline

Таймлайн, из которого нужно читать записи WAL. По умолчанию используется значение в startseg, если оно указано; в противном случае по умолчанию используется 1. Значение может быть указано в десятичном или шестнадцатеричном формате, например 17 или 0x11.

-V
--version

Выведите версию pg_waldump и завершите работу.

-w
--fullpage

Отобразить только записи, которые содержат полностраничные изображения.

-x xid
--xid=xid

Отобразить только записи, помеченные данным идентификатором транзакции.

-z
--stats[=record]

Отображение сводной статистики (количества и размера записей и полностраничных изображений) вместо отдельных записей. При необходимости можно генерировать статистику для каждой записи вместо каждого регионального менеджера.

Если pg_waldump завершается сигналом SIGINT (Control+C), то выводится сводка вычисленной статистики до точки завершения. Эта операция не поддерживается в Windows.

--save-fullpage=save_path

Сохраните полные изображения страниц, найденные в записях WAL, в каталог save_path. Сохраненные изображения подлежат тем же критериям фильтрации и ограничения, что и отображаемые записи.

Полные изображения страниц сохраняются с использованием следующего формата имени файла: TIMELINE-LSN.RELTABLESPACE.DATOID.RELNODE.BLKNOFORK Имена файлов состоят из следующих частей:

КомпонентОписание
TIMELINEХронология файла сегмента WAL, где находится запись, отформатированная как одно 8-символьное шестнадцатеричное число %08X
LSNLSN записи с этим изображением, отформатированный как два 8-символьных шестнадцатеричных числа %08X-%08X
RELTABLESPACEOID табличного пространства блока
DATOIDOID базы данных блока
RELNODEфайловый узел блока
BLKNOномер блока блока
FORK Имя форка, из которого поступило полное изображение страницы, например _main, _fsm, _vm или _init.

-?
--help

Показать справку о командной строке аргументов pg_waldump и выйти.

Окружение

PGDATA

Каталог данных; см. также опцию -p.

PG_COLOR

Определяет, следует ли использовать цвет в диагностических сообщениях. Возможные значения: always, auto и never.

Примечания

Может давать неправильные результаты при работе сервера.

Отображается только указанная временная шкала (или используется значение по умолчанию, если не указано ни одной). Записи в других временных шкалах игнорируются.

pg_waldump не может читать WAL-файлы с суффиксом .partial. Если эти файлы нужно прочитать, суффикс .partial должен быть удален из имени файла.

См. также

Раздел 28.6