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
.BLKNO
FORK
Компонент Описание TIMELINE Хронология файла сегмента WAL, где находится запись, отформатированная как одно 8-символьное шестнадцатеричное число %08X
LSN LSN записи с этим изображением, отформатированный как два 8-символьных шестнадцатеричных числа %08X-%08X
RELTABLESPACE OID табличного пространства блока DATOID OID базы данных блока RELNODE файловый узел блока BLKNO номер блока блока FORK Имя форка, из которого поступило полное изображение страницы, например _main
,_fsm
,_vm
или_init
.-?
--help
Показать справку о командной строке аргументов pg_waldump и выйти.
Окружение
PGDATA
Каталог данных; см. также опцию
-p
.PG_COLOR
Определяет, следует ли использовать цвет в диагностических сообщениях. Возможные значения:
always
,auto
иnever
.
Примечания
Может давать неправильные результаты при работе сервера.
Отображается только указанная временная шкала (или используется значение по умолчанию, если не указано ни одной). Записи в других временных шкалах игнорируются.
pg_waldump не может читать WAL-файлы с суффиксом
.partial
. Если эти файлы нужно прочитать, суффикс
.partial
должен быть удален из имени файла.