pg_waldump
pg_waldump — вывести журнал предзаписи кластера БД Postgres Pro в понятном человеку виде
Синтаксис
pg_waldump [параметр...] [начальный_сегмент [конечный_сегмент]]
Описание
Программа pg_waldump показывает содержимое журнала предзаписи (WAL) и прежде всего полезна для целей отладки и обучения.
Эту утилиту может запускать только пользователь, установивший сервер, так как ей требуется доступ на чтение к каталогу данных.
Параметры
Следующие аргументы командной строки задают расположение данных и формат вывода:
- начальный_сегмент
- Начать чтение с указанного файла сегмента журнала. Это неявно определяет каталог, в котором будут находиться файлы, и целевую линию времени. 
- конечный_сегмент
- Остановиться после чтения указанного файла сегмента журнала. 
- -b- --bkp-details
- Выводить подробные сведения о блоках-копиях страниц. 
- -e- конец- --end=- конец
- Прекратить чтение в заданной позиции в WAL, а не читать поток до конца. 
- -f- --follow
- Достигнув конца корректного WAL, проверять раз в секунду поступление новых записей WAL. 
- -n- предел- --limit=- предел
- Вывести заданное число записей и остановиться. 
- -p- путь- --path=- путь
- Задаёт каталог, содержащий файлы сегментов журнала, либо каталог с подкаталогом - pg_wal, содержащим такие файлы. По умолчанию в поисках этих файлов просматривается текущий каталог, подкаталог- pg_walтекущего каталога и подкаталог- pg_walкаталога- PGDATA.
- -q- --quiet
- Не выводить ничего кроме ошибок. Этот ключ может быть полезен, когда вы хотите узнать, можно ли полностью разобрать диапазон записей WAL, но собственно содержимое записей вас не интересует. 
- -r- менеджер_ресурсов- --rmgr=- менеджер_ресурсов
- Выводить только записи, созданные указанным менеджером ресурсов. Когда в качестве имени менеджера передаётся - list, программа выводит только список возможных имён менеджеров ресурсов и завершается.
- -s- начало- --start=- начало
- Позиция в WAL, с которой нужно начать чтение. По умолчанию чтение начинается с первой корректной записи журнала в самом первом из найденных файлов. 
- -t- линия_времени- --timeline=- линия_времени
- Линия времени, из которой будут читаться записи журнала. По умолчанию используется значение, заданное параметром - начальный_сегмент, если он присутствует, а иначе — 1.
- -V- --version
- Вывести версию pg_waldump и завершиться. 
- -x- ид_транзакции- --xid=- ид_транзакции
- Вывести только записи, относящиеся к указанной транзакции. 
- -z- --stats[=record]
- Вывести общую статистику (число и размер записей и образов полных страниц) вместо отдельных записей. Возможен вариант получения статистики по записям, а не по менеджерам ресурсов. 
- -?- --help
- Вывести справку об аргументах командной строки pg_waldump и завершиться. 
Переменные окружения
- PGDATA
- Каталог данных; также см. параметр - -p.
- PG_COLOR
- Выбирает вариант использования цвета в диагностических сообщениях. Возможные значения: - always(всегда),- auto(автоматически) и- never(никогда).
Замечания
Когда сервер работает, результаты могут быть некорректными.
Выводятся записи только указанной линии времени (или линии времени по умолчанию, если она не задана явно). Записи в других линиях времени игнорируются.
pg_waldump не будет читать файлы WAL с расширением .partial. Если требуется прочитать такие файлы, расширение .partial нужно убрать из их имён.