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 из имени файла.