Postgres Pro Enterprise
18
Postgres Pro Standard
18
PostgreSQL
18
RUENRU EN
54.2. pg_aios
Пред. НаверхГлава 54. Системные представленияНачало След.

54.2. pg_aios #

В представлении pg_aios перечисляются все используемые дескрипторы Асинхронный I/O. Дескриптор ввода-вывода ссылается на операцию ввода-вывода в состоянии подготовки, выполнения или завершения. pg_aios содержит одну строку для каждого дескриптора ввода-вывода.

Это представление прежде всего полезно для разработчиков Postgres Pro, но может также пригодиться при настройке Postgres Pro.

Таблица 54.2. Столбцы pg_aios

Тип столбца

Описание

pid int4

Идентификатор серверного процесса (PID), который инициировал операцию ввода-вывода.

io_id int4

Идентификатор дескриптора ввода-вывода. Дескрипторы используются повторно после завершения операции ввода-вывода (или если дескриптор освобождается до начала операции). При повторном использовании значение pg_aios.io_generation увеличивается.

io_generation int8

Счётчик создания дескриптора ввода-вывода.

state text

Состояние дескриптора ввода-вывода:

  • HANDED_OUT — ссылка на дескриптор есть в коде, но ещё не используется

  • DEFINED — известна информация, необходимая для выполнения

  • STAGED — операция готова к выполнению

  • SUBMITTED — операция назначена для выполнения

  • COMPLETED_IO — выполнение завершено, но результат ещё не обработан

  • COMPLETED_SHARED — завершена общая обработка результата операции

  • COMPLETED_LOCAL — завершена локальная обработка результата операции обслуживающим процессом

operation text

Операция, выполненная с помощью дескриптора ввода-вывода:

  • invalid — ещё не известна

  • readv — векторное чтение

  • writev — векторная запись

off int8

Смещение операции ввода-вывода.

length int8

Объём операции ввода-вывода.

target text

Какой тип объекта является целью операции ввода-вывода:

  • smgr — ввод-вывод для отношений

handle_data_len int2

Объём данных, связанных с операцией ввода-вывода. Для операций ввода-вывода в/из shared_buffers и temp_buffers это значение указывает на количество буферов, с которыми работает операция.

raw_result int4

Низкоуровневый результат операции ввода-вывода или NULL, если операция ещё не завершена.

result text

Высокоуровневый результат операции ввода-вывода:

  • UNKNOWN означает, что результат операции ещё не известен.

  • OK означает, что операция ввода-вывода успешно завершена.

  • PARTIAL означает, что операция ввода-вывода завершена без ошибок, но не все данные были обработаны. Как правило, вызывающему коду потребуется повторить попытку и выполнить оставшуюся работу в рамках отдельной операции ввода-вывода.

  • WARNING означает, что операция ввода-вывода завершилась без ошибок, но при её выполнении было сгенерировано предупреждение (например, при обнаружении повреждённого буфера, если включён параметр zero_damaged_pages).

  • ERROR означает, что операция ввода-вывода завершилась ошибкой.

target_desc text

Описание цели операции ввода-вывода.

f_sync bool

Флаг, показывающий, синхронно ли выполняется операция ввода-вывода.

f_localmem bool

Флаг, показывающий, ссылается ли операция ввода-вывода на локальную память процесса.

f_buffered bool

Флаг, показывающий, является ли операция ввода-вывода с буферизацией.


Представление pg_aios доступно только для чтения.

По умолчанию представление pg_aios могут читать только суперпользователи или пользователи с правами роли pg_read_all_stats.

Пред. Наверх След.
54.1. Обзор Начало 54.3. pg_available_extensions
54.2. pg_aios
Prev UpChapter 54. System ViewsHome Next

54.2. pg_aios #

The pg_aios view lists all Asynchronous I/O handles that are currently in-use. An I/O handle is used to reference an I/O operation that is being prepared, executed or is in the process of completing. pg_aios contains one row for each I/O handle.

This view is mainly useful for developers of Postgres Pro, but may also be useful when tuning Postgres Pro.

Table 54.2. pg_aios Columns

Column Type

Description

pid int4

Process ID of the server process that is issuing this I/O.

io_id int4

Identifier of the I/O handle. Handles are reused once the I/O completed (or if the handle is released before I/O is started). On reuse pg_aios.io_generation is incremented.

io_generation int8

Generation of the I/O handle.

state text

State of the I/O handle:

  • HANDED_OUT, referenced by code but not yet used

  • DEFINED, information necessary for execution is known

  • STAGED, ready for execution

  • SUBMITTED, submitted for execution

  • COMPLETED_IO, finished, but result has not yet been processed

  • COMPLETED_SHARED, shared completion processing completed

  • COMPLETED_LOCAL, backend local completion processing completed

operation text

Operation performed using the I/O handle:

  • invalid, not yet known

  • readv, a vectored read

  • writev, a vectored write

off int8

Offset of the I/O operation.

length int8

Length of the I/O operation.

target text

What kind of object is the I/O targeting:

  • smgr, I/O on relations

handle_data_len int2

Length of the data associated with the I/O operation. For I/O to/from shared_buffers and temp_buffers, this indicates the number of buffers the I/O is operating on.

raw_result int4

Low-level result of the I/O operation, or NULL if the operation has not yet completed.

result text

High-level result of the I/O operation:

  • UNKNOWN means that the result of the operation is not yet known.

  • OK means the I/O completed successfully.

  • PARTIAL means that the I/O completed without error, but did not process all data. Commonly callers will need to retry and perform the remainder of the work in a separate I/O.

  • WARNING means that the I/O completed without error, but that execution of the IO triggered a warning. E.g. when encountering a corrupted buffer with zero_damaged_pages enabled.

  • ERROR means the I/O failed with an error.

target_desc text

Description of what the I/O operation is targeting.

f_sync bool

Flag indicating whether the I/O is executed synchronously.

f_localmem bool

Flag indicating whether the I/O references process local memory.

f_buffered bool

Flag indicating whether the I/O is buffered I/O.


The pg_aios view is read-only.

By default, the pg_aios view can be read only by superusers or roles with privileges of the pg_read_all_stats role.

Prev Up Next
54.1. Overview Home 54.3. pg_available_extensions
FAQ