27.4. 進捗状況のレポート

PostgreSQL 13.1文書
		第27章データベース活動状況の監視
前へ	上へ	27.4. 進捗状況のレポート	次へ

PostgreSQLは、何らかのコマンドの実行中に進捗状況をレポートする能力があります。現在、進捗状況のレポートをサポートしているのは、ANALYZE、CLUSTER、CREATE INDEX、VACUUM、および、BASE_BACKUP(すなわち、pg_basebackupがベースバックアップのために発行するレプリケーションコマンド)のみです。将来的にサポートされるコマンドが拡大される可能性があります。

27.4.1. ANALYZEの進捗状況のレポート

ANALYZEが実行されているときにはいつでも、pg_stat_progress_analyzeビューには現在コマンドを実行している各バックエンドごとの行が含まれます。以下の表は、報告される情報を説明し、どのように解釈するかの情報を提供します。

表27.32 pg_stat_progress_analyzeビュー

列型説明
`pid` `integer` バックエンドのプロセスIDです。
`datid` `oid` バックエンドが接続されているデータベースのOIDです。
`datname` `name` バックエンドが接続されているデータベース名です。
`relid` `oid` 解析されているテーブルのOIDです。
`phase` `text` 現在処理中のフェーズです。表 27.33を参照してください。
`sample_blks_total` `bigint` サンプルされるヒープブロックの総数です。
`sample_blks_scanned` `bigint` スキャンされたヒープブロックの数です。
`ext_stats_total` `bigint` 拡張統計情報の個数です。
`ext_stats_computed` `bigint` 計算された拡張統計情報の個数です。このカウンタはフェーズが`computing extended statistics`の時にのみ増加します。
`child_tables_total` `bigint` 子テーブルの数です。
`child_tables_done` `bigint` スキャンされた子テーブルの数です。このカウンタはフェーズが`acquiring inherited sample rows`の時にのみ増加します。
`current_child_table_relid` `oid` 現在スキャンされている子テーブルのOIDです。このフィールドはフェーズが`acquiring inherited sample rows`の時のみ有効です。

列型

説明

pid integer

バックエンドのプロセスIDです。

datid oid

バックエンドが接続されているデータベースのOIDです。

datname name

バックエンドが接続されているデータベース名です。

relid oid

解析されているテーブルのOIDです。

phase text

現在処理中のフェーズです。表 27.33を参照してください。

sample_blks_total bigint

サンプルされるヒープブロックの総数です。

sample_blks_scanned bigint

スキャンされたヒープブロックの数です。

ext_stats_total bigint

拡張統計情報の個数です。

ext_stats_computed bigint

計算された拡張統計情報の個数です。このカウンタはフェーズがcomputing extended statisticsの時にのみ増加します。

child_tables_total bigint

子テーブルの数です。

child_tables_done bigint

スキャンされた子テーブルの数です。このカウンタはフェーズがacquiring inherited sample rowsの時にのみ増加します。

current_child_table_relid oid

現在スキャンされている子テーブルのOIDです。このフィールドはフェーズがacquiring inherited sample rowsの時のみ有効です。

表27.33 ANALYZEのフェーズ

フェーズ	説明
`initializing`	コマンドはヒープをスキャンし始める準備をしています。このフェーズは非常に短時間であると予想されます。
`acquiring sample rows`	コマンドはサンプル行を得るため、`relid`で指定されたテーブルを現在スキャンしています。
`acquiring inherited sample rows`	コマンドはサンプル行を得るため、子テーブルを現在スキャンしています。列`child_tables_total`、`child_tables_done`、`current_child_table_relid`はこのフェーズの進捗情報を含みます。
`computing statistics`	コマンドはテーブルスキャンの間に得られたサンプルから統計情報を計算しています。
`computing extended statistics`	コマンドはテーブルスキャンの間に得られたサンプルから拡張統計情報を計算しています。
`finalizing analyze`	コマンドは`pg_class`を更新しています。このフェーズが完了すれば、`ANALYZE`は終わります。

注記

ANALYZEがパーティションテーブルで実行される場合は、そのパーティションテーブルのすべてもANALYZEに書かれているように再帰的に解析されることに注意してください。その場合、ANALYZEの進捗はまず親テーブルについて報告され、それによってその継承の統計情報が集められ、各パーティションの報告が続きます。

27.4.2. CREATE INDEXの進捗状況のレポート

CREATE INDEXやREINDEXが実行中であるときにはいつでも、pg_stat_progress_create_indexビューには現在インデックスを作成している各バックエンドごとの行が含まれます。以下の表は、報告される情報を説明し、どのように解釈するかの情報を提供します。

表27.34 pg_stat_progress_create_indexビュー

列型説明
`pid` `integer` バックエンドのプロセスIDです。
`datid` `oid` バックエンドが接続されているデータベースのOIDです。
`datname` `name` バックエンドが接続されているデータベースの名前です。
`relid` `oid` インデックスが作られているテーブルのOIDです。
`index_relid` `oid` 作成または再作成されているインデックスのOIDです。同時作成ではない`CREATE INDEX`のときは、これは0です。
`command` `text` 実行しているコマンドで、 `CREATE INDEX`、 `CREATE INDEX CONCURRENTLY`、 `REINDEX`または`REINDEX CONCURRENTLY`です。
`phase` `text` 現在処理中のインデックス作成のフェーズです。表 27.35を参照してください。
`lockers_total` `bigint` 該当するときに、待機するロック取得者の総数です。
`lockers_done` `bigint` 既に待機したロック取得者の数です。
`current_locker_pid` `bigint` 現在待機しているロック取得者のプロセスIDです。
`blocks_total` `bigint` 現在のフェーズで処理されることになっているブロックの総数です。
`blocks_done` `bigint` 現在のフェーズで既に処理されたブロック数です。
`tuples_total` `bigint` 現在のフェーズで処理されることになっているタプルの総数です。
`tuples_done` `bigint` 現在のフェーズで既に処理されたタプル数です。
`partitions_total` `bigint` パーティションテーブル上のインデックスを作成するとき、この列にはインデックスが作られることになっているパーティションの総数が設定されます。
`partitions_done` `bigint` パーティションテーブル上のインデックスを作成するとき、この列にはインデックス作成が既に完了しているパーティションの数が設定されます。

列型

説明

pid integer

バックエンドのプロセスIDです。

datid oid

バックエンドが接続されているデータベースのOIDです。

datname name

バックエンドが接続されているデータベースの名前です。

relid oid

インデックスが作られているテーブルのOIDです。

index_relid oid

作成または再作成されているインデックスのOIDです。同時作成ではないCREATE INDEXのときは、これは0です。

command text

実行しているコマンドで、 CREATE INDEX、 CREATE INDEX CONCURRENTLY、 REINDEXまたはREINDEX CONCURRENTLYです。

phase text

現在処理中のインデックス作成のフェーズです。表 27.35を参照してください。

lockers_total bigint

該当するときに、待機するロック取得者の総数です。

lockers_done bigint

既に待機したロック取得者の数です。

current_locker_pid bigint

現在待機しているロック取得者のプロセスIDです。

blocks_total bigint

現在のフェーズで処理されることになっているブロックの総数です。

blocks_done bigint

現在のフェーズで既に処理されたブロック数です。

tuples_total bigint

現在のフェーズで処理されることになっているタプルの総数です。

tuples_done bigint

現在のフェーズで既に処理されたタプル数です。

partitions_total bigint

パーティションテーブル上のインデックスを作成するとき、この列にはインデックスが作られることになっているパーティションの総数が設定されます。

partitions_done bigint

パーティションテーブル上のインデックスを作成するとき、この列にはインデックス作成が既に完了しているパーティションの数が設定されます。

表27.35 CREATE INDEXのフェーズ

フェーズ	説明
`initializing`	`CREATE INDEX`や`REINDEX`はインデックスを作る準備をしています。このフェーズはごく短時間になると予想されます。
`waiting for writers before build`	`CREATE INDEX CONCURRENTLY`や`REINDEX CONCURRENTLY`は、潜在的にテーブルを参照するかもしれない書き込みロックを伴うトランザクションが終了するのを待機しています。本フェーズは同時モードでないときには省かれます。列`lockers_total`、`lockers_done`、および、`current_locker_pid`には本フェーズの進行情報が入ります。
`building index`	インデックスがアクセスメソッド固有のコードにより作成されています。本フェーズでは、進捗レポートをサポートするアクセスメソッドが自身の進捗データを記入し、また、サブフェーズはこの列で示されます。典型的には、`blocks_total`と`blocks_done`が、さらにあるいは`tuples_total`と`tuples_done`も、進捗データを含みます。
`waiting for writers before validation`	`CREATE INDEX CONCURRENTLY`や`REINDEX CONCURRENTLY`は、潜在的にテーブルに書き込みするかもしれない書き込みロックを伴うトランザクションが終了するのを待機しています。本フェーズは同時モードでないときには省かれます。列`lockers_total`、`lockers_done`、および、`current_locker_pid`には本フェーズの進行情報が入ります。
`index validation: scanning index`	`CREATE INDEX CONCURRENTLY`は確認が必要なタプルに対するインデックス検索をスキャンしています。本フェーズは同時モードでないときには省かれます。列`blocks_total`（インデックスの総サイズが設定される）と`blocks_done`に本フェーズの進行情報が入ります。
`index validation: sorting tuples`	`CREATE INDEX CONCURRENTLY`はインデックスをスキャンするフェーズ(scanning index)の出力をソートしています。
`index validation: scanning table`	`CREATE INDEX CONCURRENTLY`は、前の2フェーズで収集されたインデックスのタプルを確認するためテーブルをスキャンしています。本フェーズは同時モードでないときには省かれます。列`blocks_total`（テーブルの総サイズが設定される）と`blocks_done`に本フェーズの進行情報が入ります。
`waiting for old snapshots`	`CREATE INDEX CONCURRENTLY`や`REINDEX CONCURRENTLY`は、潜在的にテーブルを参照するかもしれないトランザクションがそれらのスナップショットを解放するのを待機しています。本フェーズは同時モードでないときには省かれます。列`lockers_total`、`lockers_done`、および、`current_locker_pid`には本フェーズの進行情報が入ります。
`waiting for readers before marking dead`	`REINDEX CONCURRENTLY`は、古いインデックスに無効と印付けする前に、テーブルへの読み取りロックを伴うトランザクションが終了するのを待機しています。本フェーズは同時モードでないときには省かれます。列`lockers_total`、`lockers_done`、および、`current_locker_pid`には本フェーズの進行情報が入ります。
`waiting for readers before dropping`	`REINDEX CONCURRENTLY`は、古いインデックスを削除する前に、テーブルへの読み取りロックを伴うトランザクションが終了するのを待機しています。本フェーズは同時モードでないときには省かれます。列`lockers_total`、`lockers_done`、および、`current_locker_pid`には本フェーズの進行情報が入ります。

27.4.3. VACUUMの進捗状況のレポート

VACUUMを実行するときはいつでも、pg_stat_progress_vacuumビューは、現在バキューム処理している（自動バキュームワーカプロセスを含む）それぞれのバックエンドごとに１行を格納します。以下の表は、報告される情報を説明し、どのように解釈するかの情報を提供します。 VACUUM FULLコマンドの進捗はpg_stat_progress_clusterでレポートされます。これは、通常のVACUUMはテーブル内を書き換えするのみである一方、VACUUM FULLとCLUSTERはいずれもテーブルを再作成するためです。 27.4.4を参照してください。

表27.36 pg_stat_progress_vacuumビュー

列型説明
`pid` `integer` バックエンドのプロセスIDです。
`datid` `oid` バックエンドが接続されているデータベースのOIDです。
`datname` `name` バックエンドが接続されているデータベースの名前です。
`relid` `oid` バキューム処理が行われているテーブルのOIDです。
`phase` `text` 現在処理しているバキュームのフェーズです。表 27.37を参照してください。
`heap_blks_total` `bigint` テーブルのヒープブロックの総数です。この数字は、スキャンの開始を基点としてレポートされます。後に追加されるブロックは、この`VACUUM`によって処理されません（必要もありません）。
`heap_blks_scanned` `bigint` スキャンされたヒープブロックの数です。可視性マップがスキャンを最適化するために使用されるため、いくつかのブロックが検査されずに読み飛ばされます。読み飛ばされたブロックはこの総数に含まれ、そのためこの数字はバキューム処理が完了した時に、最終的に`heap_blks_total`と同じになります。このカウンタは、フェーズが`scanning heap`の時にのみ増加します。
`heap_blks_vacuumed` `bigint` バキューム処理されたヒープブロックの数です。テーブルにインデックスが１つでも存在するなら、このカウンタはフェーズが`vacuuming heap`の時にのみ増加します。無効なタプルが含まれていないブロックは読み飛ばされ、それゆえカウンタは時々大きな増加量で早送りされます。
`index_vacuum_count` `bigint` 完了したインデックスバキュームサイクルの数です。
`max_dead_tuples` `bigint` インデックスバキュームサイクルの実行に必要となる前に格納できる、maintenance_work_memに基づいた、無効なタプルの数です。
`num_dead_tuples` `bigint` 最後のインデックスバキュームサイクルから収集された無効タプルの数です。

列型

説明

pid integer

バックエンドのプロセスIDです。

datid oid

バックエンドが接続されているデータベースのOIDです。

datname name

バックエンドが接続されているデータベースの名前です。

relid oid

バキューム処理が行われているテーブルのOIDです。

phase text

現在処理しているバキュームのフェーズです。表 27.37を参照してください。

heap_blks_total bigint

テーブルのヒープブロックの総数です。この数字は、スキャンの開始を基点としてレポートされます。後に追加されるブロックは、このVACUUMによって処理されません（必要もありません）。

heap_blks_scanned bigint

スキャンされたヒープブロックの数です。可視性マップがスキャンを最適化するために使用されるため、いくつかのブロックが検査されずに読み飛ばされます。読み飛ばされたブロックはこの総数に含まれ、そのためこの数字はバキューム処理が完了した時に、最終的にheap_blks_totalと同じになります。このカウンタは、フェーズがscanning heapの時にのみ増加します。

heap_blks_vacuumed bigint

バキューム処理されたヒープブロックの数です。テーブルにインデックスが１つでも存在するなら、このカウンタはフェーズがvacuuming heapの時にのみ増加します。無効なタプルが含まれていないブロックは読み飛ばされ、それゆえカウンタは時々大きな増加量で早送りされます。

index_vacuum_count bigint

完了したインデックスバキュームサイクルの数です。

max_dead_tuples bigint

インデックスバキュームサイクルの実行に必要となる前に格納できる、maintenance_work_memに基づいた、無効なタプルの数です。

num_dead_tuples bigint

最後のインデックスバキュームサイクルから収集された無効タプルの数です。

表27.37 VACUUMのフェーズ

フェーズ	説明
`initializing`	`VACUUM`は、ヒープをスキャンし始める準備をしています。このフェーズは、非常に短時間であると予想されます。
`scanning heap`	`VACUUM`は、現在ヒープをスキャン中です。必要であればそれぞれのページを切り取り、デフラグし、場合によってはフリーズ活動を実行します。スキャンの進捗状況の監視に`heap_blks_scanned`列が使用できます。
`vacuuming indexes`	`VACUUM`は、現在インデックスをバキューム処理中です。テーブルにインデックスが存在する場合、ヒープが完全にスキャンされた後に、バキューム実行ごとに少なくとも１回発生します。 maintenance_work_memが、発見された無効タプルの数量を格納するのに不十分な場合は、バキューム実行ごとに複数回発生する可能性があります。
`vacuuming heap`	`VACUUM`は、現在ヒープをバキューム処理中です。ヒープのバキュームは、ヒープのスキャンと異なり、インデックスをバキューム処理するそれぞれのインスタンスの後に発生します。 `heap_blks_scanned`が`heap_blks_total`より少ない場合、システムはこのフェーズの完了後にヒープのスキャン処理に戻ります。さもなければ、このフェーズの完了後にインデックスの整理を始めます。
`cleaning up indexes`	`VACUUM`は、現在インデックスの整理処理中です。これは、ヒープが完全にスキャンされ、インデックスとヒープが完全にすべてバキューム処理された後に発生します。
`truncating heap`	`VACUUM`は、現在リレーションの終点の空のページをオペレーティングシステムに戻すためにヒープを切り詰めています。これは、インデックスの整理処理後に発生します。
`performing final cleanup`	`VACUUM`は、最終クリーンアップ処理をしています。このフェーズの間、`VACUUM`空き領域マップをバキュームし、`pg_class`の統計情報を更新し、統計情報コレクタに統計情報を報告します。このフェーズが完了した時、`VACUUM`は終了します。

27.4.4. CLUSTERの進捗状況のレポート

CLUSTERやVACUUM FULLが実行されているときにはいつでも、pg_stat_progress_clusterビューには現在いずれかのコマンドを実行している各バックエンドごとの行が含まれます。以下の表は、報告される情報を説明し、どのように解釈するかの情報を提供します。

表27.38 pg_stat_progress_clusterビュー

列型説明
`pid` `integer` バックエンドのプロセスIDです。
`datid` `oid` バックエンドが接続されているデータベースのOIDです。
`datname` `name` バックエンドが接続されているデータベースの名前です。
`relid` `oid` クラスタ化されているテーブルのOIDです。
`command` `text` 実行しているコマンドです。 `CLUSTER`か`VACUUM FULL`のいずれかです。
`phase` `text` 現在処理しているフェーズです。表 27.39を参照してください。
`cluster_index_relid` `oid` テーブルがインデックスを使ってスキャンされているのであれば、これは使われているインデックスのOIDで、さもなくばゼロです。
`heap_tuples_scanned` `bigint` スキャンされたヒープタプルの数です。このカウンタは、フェーズが`seq scanning heap`、`index scanning heap`、または、`writing new heap`であるときのみ増加します。
`heap_tuples_written` `bigint` 書かれたヒープタプルの数です。このカウンタは、フェーズが`seq scanning heap`、`index scanning heap`、または、`writing new heap`であるときのみ増加します。
`heap_blks_total` `bigint` テーブル内のヒープブロックの総数です。この数には`seq scanning heap`の開始時の値が報告されます。
`heap_blks_scanned` `bigint` スキャンされたヒープブロックの数です。このカウンタは、フェーズが`seq scanning heap`であるときのみ増加します。
`index_rebuild_count` `bigint` インデックス再作成の数です。このカウンタはフェーズが`rebuilding index`であるときのみ増加します。

列型

説明

pid integer

バックエンドのプロセスIDです。

datid oid

バックエンドが接続されているデータベースのOIDです。

datname name

バックエンドが接続されているデータベースの名前です。

relid oid

クラスタ化されているテーブルのOIDです。

command text

実行しているコマンドです。 CLUSTERかVACUUM FULLのいずれかです。

phase text

現在処理しているフェーズです。表 27.39を参照してください。

cluster_index_relid oid

テーブルがインデックスを使ってスキャンされているのであれば、これは使われているインデックスのOIDで、さもなくばゼロです。

heap_tuples_scanned bigint

スキャンされたヒープタプルの数です。このカウンタは、フェーズがseq scanning heap、index scanning heap、または、writing new heapであるときのみ増加します。

heap_tuples_written bigint

書かれたヒープタプルの数です。このカウンタは、フェーズがseq scanning heap、index scanning heap、または、writing new heapであるときのみ増加します。

heap_blks_total bigint

テーブル内のヒープブロックの総数です。この数にはseq scanning heapの開始時の値が報告されます。

heap_blks_scanned bigint

スキャンされたヒープブロックの数です。このカウンタは、フェーズがseq scanning heapであるときのみ増加します。

index_rebuild_count bigint

インデックス再作成の数です。このカウンタはフェーズがrebuilding indexであるときのみ増加します。

表27.39 CLUSTERとVACUUM FULLのフェーズ

フェーズ	説明
`initializing`	コマンドはヒープのスキャンを開始する準備をしています。本フェーズはごく短時間になると予想されます。
`seq scanning heap`	コマンドは現在、テーブルをシーケンシャルスキャンを使ってスキャンしています。
`index scanning heap`	`CLUSTER`は現在、インデックススキャンを使ってテーブルをスキャンしています。
`sorting tuples`	`CLUSTER`は現在、タプルをソートしています。
`writing new heap`	`CLUSTER`が新しいヒープに書き込んでいます。
`swapping relation files`	コマンドは現在、新たに構築したファイルを置き換えて設置しています。
`rebuilding index`	コマンドは現在、インデックスを再構築しています。
`performing final cleanup`	コマンドは現在、最終クリーンアップを実行中です。このフェーズが完了すると、`CLUSTER`や`VACUUM FULL`は終了します。

27.4.5. ベースバックアップの進捗状況のレポート

pg_basebackupのようなアプリケーションがベースバックアップを取る時はいつでも、pg_stat_progress_basebackupビューには現在BASE_BACKUPレプリケーションコマンドを実行し、バックアップをストリームしている各WAL送信プロセスごとの行が含まれます。以下の表は、報告される情報を説明し、どのように解釈するかの情報を提供します。

表27.40 pg_stat_progress_basebackupビュー

列型説明
`pid` `integer` WAL送信プロセスのプロセスIDです。
`phase` `text` 現在処理中のフェーズです。表 27.41を参照してください。
`backup_total` `bigint` ストリームされるデータの総量です。これは推定され、`streaming database files`フェーズの最初に報告されます。データベースは`streaming database files`フェーズの間に変化するかもしれませんし、WALログが後ほどバックアップに含められますので、これは近似でしかないことに注意してください。ストリームされたデータ量が推定された総量を超えたら、これは常に`backup_streamed`と同じ値です。 pg_basebackupで推定が無効にされて(すなわち、`--no-estimate-size`オプションが指定されて)いれば、`NULL`です。
`backup_streamed` `bigint` ストリームされるデータの量です。このカウンタはフェーズが`streaming database files`または`transferring wal files`の時にのみ増加します。
`tablespaces_total` `bigint` ストリームされるテーブル空間の総数です。
`tablespaces_streamed` `bigint` ストリームされたテーブル空間の数です。このカウンタはフェーズが`streaming database files`の時にのみ増加します。

列型

説明

pid integer

WAL送信プロセスのプロセスIDです。

phase text

現在処理中のフェーズです。表 27.41を参照してください。

backup_total bigint

ストリームされるデータの総量です。これは推定され、streaming database filesフェーズの最初に報告されます。データベースはstreaming database filesフェーズの間に変化するかもしれませんし、WALログが後ほどバックアップに含められますので、これは近似でしかないことに注意してください。ストリームされたデータ量が推定された総量を超えたら、これは常にbackup_streamedと同じ値です。 pg_basebackupで推定が無効にされて(すなわち、--no-estimate-sizeオプションが指定されて)いれば、NULLです。

backup_streamed bigint

ストリームされるデータの量です。このカウンタはフェーズがstreaming database filesまたはtransferring wal filesの時にのみ増加します。

tablespaces_total bigint

ストリームされるテーブル空間の総数です。

tablespaces_streamed bigint

ストリームされたテーブル空間の数です。このカウンタはフェーズがstreaming database filesの時にのみ増加します。

表27.41 ベースバックアップのフェーズ

フェーズ	説明
`initializing`	WAL送信プロセスはバックアップを開始する準備をしています。このフェーズはごく短時間になると予想されます。
`waiting for checkpoint to finish`	WAL送信プロセスは、ベースバックアップを取る準備をするために現在`pg_start_backup`を実行し、バックアップ開始チェックポイントが完了するのを待っています。
`estimating backup size`	WAL送信プロセスは、ベースバックアップとしてストリームされるデータベースファイルの総量を現在推定しています。
`streaming database files`	WAL送信プロセスはデータベースファイルをベースバックアップとして現在ストリームしています。
`waiting for wal archiving to finish`	WAL送信プロセスは、バックアップを終了するために現在`pg_stop_backup`を実行し、ベースバックアップに必要なWALファイルすべてのアーカイブに成功するのを待っています。 pg_basebackupで`--wal-method=none`か`--wal-method=stream`のいずれかが指定されれば、バックアップはこのフェーズが完了したら終了します。
`transferring wal files`	WAL送信プロセスはバックアップ中に生成されたWALログをすべて現在転送しています。 pg_basebackupで`--wal-method=fetch`が指定されていれば、このフェーズが`waiting for wal archiving to finish`の次に来ます。バックアップはこのフェーズが完了したら終了します。

前へ	上へ	次へ
27.3. ロックの表示	ホーム	27.5. 動的追跡