qhb_waldump

qhb_waldump — отобразить журнал упреждающей записи кластера баз данных QHB в удобочитаемом виде


Синтаксис

qhb_waldump [параметр...] [начальный_сегмент [конечный_сегмент]]

Описание

Утилита qhb_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
Вывести версию qhb_waldump и завершиться.

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

-z
--stats[=record]
Отобразить сводную статистику (количество и размер записей и образов полных страниц) вместо отдельных записей. Дополнительно можно генерировать статистику для каждой записи, а не по менеджерам ресурсов.

-?
--help
Показать справку об аргументах командной строки qhb_waldump и завершиться.


Переменные среды

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

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

Примечания

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

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

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


См. также

Внутреннее устройство WAL