Postgres Pro Enterprise : Документация: 12: pg_filedump : Компания Postgres Professional

pg_filedump
Пред.	Наверх	G.2. Серверные приложения	Начало	След.

pg_filedump

pg_filedump — отображает отформатированное содержимое файлов кучи, индексов или управляющего файла Postgres Pro

Синтаксис

pg_filedump [параметр...] [файл]

Описание

pg_filedump — утилита для представления управляющего файла и файлов кучи/индекса Postgres Pro в удобочитаемом виде. Вы можете форматировать/выводить содержимое файлов несколькими способами, описанными в разделе Параметры, а также выводить данные непосредственно в двоичном виде. Тип файла (куча/индекс) обычно определяется автоматически по содержимому блоков внутри файла. Однако чтобы прочитать содержимое файла pg_control, необходимо использовать параметр -c. По умолчанию весь файл обрабатывается с размером блока, указанным в блоке 0, и отображаются относительные адреса блоков. Значения по умолчанию можно изменить с помощью параметров времени выполнения. Некоторые параметры могут показаться странными, но они необходимы. Например, размер блока может потребоваться задать, если заголовок блока 0 был повреждён.

Установка

pg_filedump поставляется вместе с Postgres Pro в виде отдельного пакета pg-filedump-ent-12 (подробные инструкции по установке приведены в Главе 17).

Параметры

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

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

-a

Отображать абсолютные адреса. Содержимое заголовка блока всегда адресуется относительно блока.

-b

Выводить двоичные образы блоков в заданном диапазоне. При этом все остальные параметры форматирования не действуют.

-d

Показать отформатированный вывод байтов блока. При этом все остальные параметры форматирования не действуют.

-D список_атрибутов

Декодировать кортежи, используя заданный список типов, разделённых запятыми. Список поддерживаемых типов:

bigint

bigserial

bool

char

charN — char(n)

date

float

float4

float8

int

json

macaddr

name

numeric

oid

real

serial

smallint

smallserial

text

time

timestamp

timetz

uuid

varchar

varcharN — varchar(n)

xid

xml

~ — игнорировать все последующие атрибуты в кортеже.

-f

Показать отформатированный вывод байтов блока вместе с интерпретацией.

-h

Показать справку.

-i

Выводить подробную информацию об интерпретируемых элементах.

-k

Проверять контрольные суммы блоков.

-o

Не выводить старые значения.

-R начальный_блок [конечный_блок]

Показать только заданные диапазоны блоков в файле. Блоки нумеруются, начиная с 0. Параметры начальный_блок и конечный_блок определяют первый и последний блок диапазона, соответственно. Если конечный_блок опускается, а задаётся только начальный_блок, будет обработан только один этот блок.

-s размер_сегмента

Задать размер сегмента равным значению размер_сегмента.

-t

Обрабатывать файлы TOAST.

-v

Вывести дополнительную информацию об отношениях TOAST.

-n номер_сегмента

Задать номер сегмента равным значению номер_сегмента.

-S размер_блока

Задать размер блока равным значению размер_блока.

-x

Форматировать элементы блока как элементы индекса.

-y

Форматировать элементы блока как элементы кучи.

Для управляющих файлов действуют следующие параметры:

-c: Интерпретировать указанный файл как управляющий файл.
-f: Показать отформатированный вывод байтов содержимого вместе с интерпретацией.
-S размер_блока: Задать размер блока равным значению размер_блока.

Дополнительные параметры:

-m: Интерпретировать файл как файл pg_filenode.map и вывести его содержимое. Все остальные параметры будут проигнорированы.

В большинстве случаев рекомендуется использовать параметры -i и -f, чтобы получить наиболее информативный вывод.

Автор

Патрик Макдональд <patrickm@redhat.com>

Пред.	Наверх	След.
pgbouncer	Начало	pgpro_controldata

pg_filedump
Prev	Up	G.2. Server Applications	Home	Next

pg_filedump

pg_filedump — display formatted contents of a Postgres Pro heap, index, or control file

Synopsis

pg_filedump [option...] [file]

Description

pg_filedump is a utility to format Postgres Pro heap/index/control files into a human-readable form. You can format/dump the files several ways, as listed in the Options section, as well as dump a straight binary. The type of file (heap/index) can usually be determined automatically by the content of the blocks within the file. However, to format a pg_control file you must use the -c option. The default is to format the entire file using the block size listed in block 0 and display block relative addresses. These defaults can be modified using run-time options. Some options may seem strange but they are there for a reason. For example, block size. It is there because if the header of block 0 is corrupt, you need a method of forcing a block size.

Installation

pg_filedump is provided with Postgres Pro as a separate pre-built package pg-filedump-ent-12 (for the detailed installation instructions, see Chapter 17).

Options

Defaults are: relative addressing, range of the entire file, block size as listed on block 0 in the file.

The following options are valid for heap and index files:

-a

Display absolute addresses when formatting. Block header information is always block-relative.

-b

Display binary block images within a range. The option will turn off all formatting options.

-d

Display formatted block content dump. The option will turn off all other formatting options.

-D attrlist

Decode tuples using given comma-separated list of types. The list of supported types:

bigint

bigserial

bool

char

charN — char(n)

date

float

float4

float8

int

json

macaddr

name

numeric

oid

real

serial

smallint

smallserial

text

time

timestamp

timetz

uuid

varchar

varcharN — varchar(n)

xid

xml

~ — ignore all attributes left in a tuple

-f

Display formatted block content dump along with interpretation.

-h

Display help.

-i

Display interpreted item details.

-k

Verify block checksums.

-o

Do not dump old values.

-R startblock [endblock]

Display specific block ranges within the file. Blocks are indexed from 0. startblock: block to start at. endblock: block to end at. A startblock without an endblock will format a single block.

-s segsize

Force segment size to segsize.

-t

Dump TOAST files.

-v

Output additional information about TOAST relations.

-n segnumber

Force segment number to segnumber.

-S blocksize

Force block size to blocksize.

-x

Force interpreted formatting of block items as index items.

-y

Force interpreted formatting of block items as heap items.

The following options are valid for control files:

-c: Interpret the file listed as a control file.
-f: Display formatted content dump along with interpretation.
-S blocksize: Force block size to blocksize.

Additional parameters:

-m: Interpret file as pg_filenode.map file and print contents. All other options will be ignored.

In most cases, it is recommended to use the -i and -f options to get the most useful dump output.

Author

Patrick Macdonald <patrickm@redhat.com>

Prev	Up	Next
pgbouncer	Home	pgpro_controldata