qhb_waldump
qhb_waldump — отобразить журнал упреждающей записи кластера баз данных QHB в удобочитаемом виде
Синтаксис
qhb_waldump [параметр...] [начальный_сегмент [конечный_сегмент]]
Описание
Утилита qhb_waldump отображает журнал упреждающей записи (WAL) и в основном полезна для отладки или обучения.
Эту утилиту может запустить только тот пользователь, который установил сервер, поскольку для нее требуется доступ только для чтения к каталогу данных.
Параметры
Следующие параметры командной строки управляют расположением и форматом вывода:
начальный_сегмент
Начать чтение с указанного файла сегмента WAL. Это неявно определяет путь, по
которому будет выполняться поиск файлов, и временную шкалу для использования.
конечный_сегмент
Остановиться после прочтения указанного файла сегмента WAL.
-b
--bkp-details
Выводить подробную информацию о резервных блоках страниц.
-B блок
--block=блок
Отобразить только записи, модифицирующие заданный блок. При этом также следует
предоставить отношение с помощью параметра --relation или -R.
-e конец
--end=конец
Прекратить чтение в указанном месте WAL вместо чтения потока журнала до конца.
-f
--follow
Достигнув конца корректного WAL, продолжать делать запрос раз в секунду на предмет
появления новых записей WAL.
-F ветвь
--fork=ветвь
Если имеются, отображать только записи, модифицирующие блоки в заданной ветви.
Допустимые значение: main (основная ветвь), fsm (карта свободного пространства),
vm (карта видимости) и init (ветвь инициализации).
-n предел
--limit=предел
Отобразить указанное количество записей и остановиться.
-p путь
--path=путь
Задает каталог для поиска файлов сегментов WAL или каталог с подкаталогом
pg_wal, который содержит такие файлы. По умолчанию выполняется поиск в
текущем каталоге, подкаталоге pg_wal текущего каталога и подкаталоге
pg_wal каталога PGDATA.
-q
--quiet
Не выводить ничего, кроме ошибок. Этот параметр может быть полезен, когда вы
хотите узнать, можно ли успешно проанализировать диапазон записей WAL, но
содержимое записей вас не интересует.
-r менеджер_ресурсов
--rmgr=менеджер_ресурсов
Выводить только записи, сгенерированные указанным менеджером ресурсов. Если в
качестве имени передается list, то вывести список допустимых имен менеджеров
ресурсов и завершиться.
Расширения могут определять пользовательские менеджеры ресурсов, но
qhb_waldump не загружает модули расширений и, следовательно, не распознает
пользовательские менеджеры ресурсов по имени. Вместо этого можно задать
пользовательские менеджеры ресурсов в виде custom###, где «###» —
трехзначный идентификатор менеджера ресурсов. Имена в такой форме всегда будут
считаться допустимыми.
-R табл_пространство/бд/отношение
--relation=табл_пространство/бд/отношение
Отобразить только записи, модифицирующие блоки в заданном отношении. Отношение
указывается с OID табличного пространства, OID базы данных и номером файлового
узла отношения, разделенных слэшами, например, 1234/12345/12345. Этот же формат
используется для отношений в выводе программы.
-s начало
--start=начало
Место в WAL, с которого нужно начать чтение. По умолчанию чтение начинается с
первой корректной записи WAL в самом первом найденном файле.
-t временная_шкала
--timeline=временная_шкала
Временная шкала, с которой нужно читать записи WAL. По умолчанию используется
значение параметра начальный_сегмент (если он задан); в противном случае
значение по умолчанию равно 1. Значение можно задать в десятичном или
шестнадцатеричном виде, например 17 или 0x11.
-V
--version
Вывести версию qhb_waldump и завершиться.
-w
--fullpage
Отобразить только записи, содержащие образы полных страниц.
-x xid
--xid=xid
Отобразить только записи, отмеченные указанным идентификатором транзакции.
-z
--stats[=record]
Отобразить сводную статистику (количество и размер записей и образов полных
страниц) вместо отдельных записей. Дополнительно можно генерировать статистику
для каждой записи, а не по менеджерам ресурсов.
Если qhb_waldump прерывается сигналом SIGINT (Control+C), в сводке
по рассчитанной статистике выводятся данные вплоть до момента прерывания.
--save-fullpage=путь_сохранения
Сохранять образы полных страниц, найденные в записях WAL, в каталог
путь_сохранения. На сохраняемые образы действуют те же критерии фильтрования
и ограничения, что и на выводимые записи.
Образы полных страниц сохраняются с именами следующего формата: 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
Показать справку об аргументах командной строки qhb_waldump и завершиться.
Операционная среда
PGDATA
Каталог данных; см. также параметр -p.
PG_COLOR
Указывает, использовать ли цвет в диагностических сообщениях. Возможные значения:
always (всегда), auto (автоматически) и never (никогда).
Примечания
Во время работы сервера может дать неправильные результаты.
Отображается только указанная временная шкала (или значение по умолчанию, если она не указана). Записи в других временных шкалах игнорируются.
Утилита qhb_waldump не может читать файлы WAL с суффиксом .partial. Если эти файлы нужно прочитать, следует удалить суффикс .partial из имени файла.