53.2. pg

PostgreSQL 18.2文書
		第53章システムビュー	誤訳等の報告
前へ	上へ	53.2. `pg_aios`	次へ

53.2. `pg_aios` #

The <structname>pg_aios</structname> view lists all <xref linkend="glossary-aio"/> 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. <structname>pg_aios</structname> contains one row for each I/O handle. pg_aiosビューは、現在使用中のすべてのAsynchronous I/O【非同期I/O】ハンドルを列挙します。 I/Oハンドルは、準備中、実行中、または完了処理中のI/O操作を参照するために使用されます。 pg_aiosには、各I/Oハンドルごとに1つの行が含まれます。

This view is mainly useful for developers of <productname>PostgreSQL</productname>, but may also be useful when tuning <productname>PostgreSQL</productname>. このビューは、主にPostgreSQLの開発者にとって有用ですが、PostgreSQLをチューニングするときにも役立つ場合があります。

表53.2 pg_aiosの列

<title><structname>pg_aios</structname> Columns</title>

Column Type 列型 Description 説明
`pid` `int4` Process ID of the server process that is issuing this I/O. このI/Oを発行しているサーバプロセスのプロセスID。
`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 <link linkend="view-pg-aios-io-generation"> <structname>pg_aios</structname>.<structfield>io_generation</structfield> </link> is incremented. I/Oハンドルの識別子。ハンドルはI/Oが完了すると（またはI/Oが開始される前にハンドルが解放された場合に）再利用されます。再利用されると、`pg_aios`.`io_generation`が増加します。
`io_generation` `int8` Generation of the I/O handle. I/Oハンドルの世代。
`state` `text` State of the I/O handle: I/Oハンドルの状態は以下です。 <literal>HANDED_OUT</literal>, referenced by code but not yet used `HANDED_OUT`、コードから参照されていますが、まだ使用されていません <literal>DEFINED</literal>, information necessary for execution is known `DEFINED`、実行に必要な情報がわかっています <literal>STAGED</literal>, ready for execution `STAGED`、実行の準備が完了しています <literal>SUBMITTED</literal>, submitted for execution `SUBMITTED`、実行するように送信しました <literal>COMPLETED_IO</literal>, finished, but result has not yet been processed `COMPLETED_IO`、終了しましたが、結果はまだ処理されていません <literal>COMPLETED_SHARED</literal>, shared completion processing completed `COMPLETED_SHARED`、共有完了処理が完了しました <literal>COMPLETED_LOCAL</literal>, backend local completion processing completed `COMPLETED_LOCAL`、バックエンドのローカル完了処理が完了しました
`operation` `text` Operation performed using the I/O handle: I/Oハンドルを使用して行われる操作は以下です。 <literal>invalid</literal>, not yet known `invalid`、まだ不明です <literal>readv</literal>, a vectored read `readv`、ベクトル化された読み取りです <literal>writev</literal>, a vectored write `writev`、ベクトル化された書き込みです
`off` `int8` Offset of the I/O operation. I/O操作のオフセット。
`length` `int8` Length of the I/O operation. I/O操作の長さ。
`target` `text` What kind of object is the I/O targeting: I/O対象のオブジェクト種別は以下です。 <literal>smgr</literal>, I/O on relations `smgr`、リレーションに対するI/Oです
`handle_data_len` `int2` Length of the data associated with the I/O operation. For I/O to/from <xref linkend="guc-shared-buffers"/> and <xref linkend="guc-temp-buffers"/>, this indicates the number of buffers the I/O is operating on. I/O操作に関連するデータの長さ。 shared_buffersとtemp_buffersに対するI/Oの場合、I/Oが行われているバッファの数を示します。
`raw_result` `int4` Low-level result of the I/O operation, or NULL if the operation has not yet completed. I/O操作の低レベルの結果。操作がまだ完了していない場合はNULLになります。
`result` `text` High-level result of the I/O operation: I/O操作の高レベルの結果は以下になります。 <literal>UNKNOWN</literal> means that the result of the operation is not yet known. `UNKNOWN`は、操作の結果がまだ不明であることを意味します。 <literal>OK</literal> means the I/O completed successfully. `OK`は、I/Oが正常に完了したことを意味します。 <literal>PARTIAL</literal> 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. `PARTIAL`は、I/Oがエラーなしで完了したが、すべてのデータが処理されなかったことを意味します。通常、呼び出し側は再試行して残りの作業を別のI/Oで実行する必要があります。 <literal>WARNING</literal> 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 <xref linkend="guc-zero-damaged-pages"/> enabled. `WARNING`は、I/Oはエラーなく完了したが、IOの実行により警告が発生したことを意味します。たとえば、zero_damaged_pagesを有効化した状態で破損したバッファに遭遇した場合などです。 <literal>ERROR</literal> means the I/O failed with an error. `ERROR`は、I/Oがエラーで失敗したことを意味します。
`target_desc` `text` Description of what the I/O operation is targeting. I/O操作の対象になるものの説明。
`f_sync` `bool` Flag indicating whether the I/O is executed synchronously. I/Oが同期的に実行されるかどうかを示すフラグ。
`f_localmem` `bool` Flag indicating whether the I/O references process local memory. I/Oがプロセスのローカルメモリを参照しているかどうかを示すフラグ。
`f_buffered` `bool` Flag indicating whether the I/O is buffered I/O. I/Oがバッファ付きI/Oかどうかを示すフラグ。

Column Type 列型

Description 説明

pid int4

Process ID of the server process that is issuing this I/O. このI/Oを発行しているサーバプロセスのプロセスID。

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 <link linkend="view-pg-aios-io-generation"> <structname>pg_aios</structname>.<structfield>io_generation</structfield> </link> is incremented. I/Oハンドルの識別子。ハンドルはI/Oが完了すると（またはI/Oが開始される前にハンドルが解放された場合に）再利用されます。再利用されると、pg_aios.io_generationが増加します。

io_generation int8

Generation of the I/O handle. I/Oハンドルの世代。

state text

State of the I/O handle: I/Oハンドルの状態は以下です。

<literal>HANDED_OUT</literal>, referenced by code but not yet used HANDED_OUT、コードから参照されていますが、まだ使用されていません
<literal>DEFINED</literal>, information necessary for execution is known DEFINED、実行に必要な情報がわかっています
<literal>STAGED</literal>, ready for execution STAGED、実行の準備が完了しています
<literal>SUBMITTED</literal>, submitted for execution SUBMITTED、実行するように送信しました
<literal>COMPLETED_IO</literal>, finished, but result has not yet been processed COMPLETED_IO、終了しましたが、結果はまだ処理されていません
<literal>COMPLETED_SHARED</literal>, shared completion processing completed COMPLETED_SHARED、共有完了処理が完了しました
<literal>COMPLETED_LOCAL</literal>, backend local completion processing completed COMPLETED_LOCAL、バックエンドのローカル完了処理が完了しました

operation text

Operation performed using the I/O handle: I/Oハンドルを使用して行われる操作は以下です。

<literal>invalid</literal>, not yet known invalid、まだ不明です
<literal>readv</literal>, a vectored read readv、ベクトル化された読み取りです
<literal>writev</literal>, a vectored write writev、ベクトル化された書き込みです

off int8

Offset of the I/O operation. I/O操作のオフセット。

length int8

Length of the I/O operation. I/O操作の長さ。

target text

What kind of object is the I/O targeting: I/O対象のオブジェクト種別は以下です。

<literal>smgr</literal>, I/O on relations smgr、リレーションに対するI/Oです

handle_data_len int2

Length of the data associated with the I/O operation. For I/O to/from <xref linkend="guc-shared-buffers"/> and <xref linkend="guc-temp-buffers"/>, this indicates the number of buffers the I/O is operating on. I/O操作に関連するデータの長さ。 shared_buffersとtemp_buffersに対するI/Oの場合、I/Oが行われているバッファの数を示します。

raw_result int4

Low-level result of the I/O operation, or NULL if the operation has not yet completed. I/O操作の低レベルの結果。操作がまだ完了していない場合はNULLになります。

result text

High-level result of the I/O operation: I/O操作の高レベルの結果は以下になります。

<literal>UNKNOWN</literal> means that the result of the operation is not yet known. UNKNOWNは、操作の結果がまだ不明であることを意味します。
<literal>OK</literal> means the I/O completed successfully. OKは、I/Oが正常に完了したことを意味します。
<literal>PARTIAL</literal> 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. PARTIALは、I/Oがエラーなしで完了したが、すべてのデータが処理されなかったことを意味します。通常、呼び出し側は再試行して残りの作業を別のI/Oで実行する必要があります。
<literal>WARNING</literal> 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 <xref linkend="guc-zero-damaged-pages"/> enabled. WARNINGは、I/Oはエラーなく完了したが、IOの実行により警告が発生したことを意味します。たとえば、zero_damaged_pagesを有効化した状態で破損したバッファに遭遇した場合などです。
<literal>ERROR</literal> means the I/O failed with an error. ERRORは、I/Oがエラーで失敗したことを意味します。

target_desc text

Description of what the I/O operation is targeting. I/O操作の対象になるものの説明。

f_sync bool

Flag indicating whether the I/O is executed synchronously. I/Oが同期的に実行されるかどうかを示すフラグ。

f_localmem bool

Flag indicating whether the I/O references process local memory. I/Oがプロセスのローカルメモリを参照しているかどうかを示すフラグ。

f_buffered bool

Flag indicating whether the I/O is buffered I/O. I/Oがバッファ付きI/Oかどうかを示すフラグ。

The <structname>pg_aios</structname> view is read-only. pg_aiosビューは読み取り専用です。

By default, the <structname>pg_aios</structname> view can be read only by superusers or roles with privileges of the <literal>pg_read_all_stats</literal> role. デフォルトではpg_aiosビューはスーパーユーザか、pg_read_all_statsロールの権限を持つロールだけが読み取りできます。

前へ	上へ	次へ
53.1. 概要	ホーム	53.3. `pg_available_extensions`

53.2. pg_aios #

53.2. `pg_aios` #