pg_waldump#

pg_waldump
pg_waldump
Назад НаверхПриложения сервера PostgreSQLНачало Далее

pg_waldump

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

Синтаксис

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

Описание

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

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

Опции

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

startseg

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

endseg

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

-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

Указывает каталог для поиска файлов сегментов журнала или каталог с подкаталогом 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, с которого начать чтение. По умолчанию начинается чтение первой допустимой записи журнала, найденной в самом раннем файле.

-t timeline
--timeline=timeline

Временная шкала, из которой считываются журнальные записи. По умолчанию используется значение в теге startseg, если оно указано; в противном случае, значение по умолчанию равно 1.

-V
--version

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

-w
--fullpage

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

-x xid
--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 должен быть удален из имени файла.

См. также

Раздел 29.6
Назад Наверх Далее
pg_upgrade Начало postgres