他のバージョンの文書 12 | 11 | 10 | 9.6 | 9.5 | 9.4 | 9.3 | 9.2 | 9.1 | 9.0 | 8.4 | 8.3 | 8.2 | 8.1 | 8.0 | 7.4 | 7.3 | 7.2

F.24. pg_buffercache

pg_buffercacheモジュールは、共有バッファキャッシュで何が起きているかをリアルタイムに確認する方法を提供します。

このモジュールはレコード集合を返すpg_buffercache_pages C関数と、簡単に利用できるようにこの関数を隠蔽するpg_buffercacheビューを提供します。

デフォルトでは、使用はスーパーユーザとpg_monitorロールのメンバに限定されています。 GRANTを使って他人にアクセス権を付与できます。

F.24.1. pg_buffercacheビュー

ビューによって公開されている列の定義を表 F.15に示します。

表F.15 pg_buffercacheの列

名前参照説明
bufferidinteger 1からshared_buffersまでの範囲で示されるID
relfilenodeoidpg_class.relfilenodeリレーションのファイルノード番号
reltablespaceoidpg_tablespace.oidリレーションのテーブル空間OID
reldatabaseoidpg_database.oidリレーションのデータベースOID
relforknumbersmallint リレーション内のフォーク番号。include/common/relpath.h参照
relblocknumberbigint リレーション内のページ番号
isdirtyboolean ダーティページかどうか
usagecountsmallint Clock-sweepアクセスカウント
pinning_backendsinteger このバッファをピン留めしているバックエンドの数

共有キャッシュ内の各バッファに対して、1行が存在します。 未使用のバッファは、bufferidを除き、すべてのフィールドがNULLになります。 共有システムカタログは、OIDがゼロのデータベースに属するものとして表示されます。

キャッシュはすべてのデータベースで共有されているため、現在のデータベースに属さないリレーションのページも表示されます。 これは、一部の行に対して一致するpg_classの結合行が存在しない、間違った結合をしてしまう可能性すらあることを意味します。 pg_classに対して結合しようとする場合、現在のデータベースのOIDまたは0と等しいreldatabaseを持つ行に限定して結合することをお勧めします。

ビューが表示するバッファ状態データのコピーのために、バッファマネージャのロックを取得しません。このため、pg_buffercacheビューへのアクセスは、通常のバッファ処理への影響がより小さくなりますが、バッファすべてに渡る矛盾のない結果を提供しません。 しかしながら、各バッファの情報に自己矛盾がないことは保証されます。

F.24.2. サンプル出力

regression=# SELECT n.nspname, c.relname, count(*) AS buffers
             FROM pg_buffercache b JOIN pg_class c
             ON b.relfilenode = pg_relation_filenode(c.oid) AND
                b.reldatabase IN (0, (SELECT oid FROM pg_database
                                      WHERE datname = current_database()))
             JOIN pg_namespace n ON n.oid = c.relnamespace
             GROUP BY n.nspname, c.relname
             ORDER BY 3 DESC
             LIMIT 10;

  nspname   |        relname         | buffers
------------+------------------------+---------
 public     | delete_test_table      |     593
 public     | delete_test_table_pkey |     494
 pg_catalog | pg_attribute           |     472
 public     | quad_poly_tbl          |     353
 public     | tenk2                  |     349
 public     | tenk1                  |     349
 public     | gin_test_idx           |     306
 pg_catalog | pg_largeobject         |     206
 public     | gin_test_tbl           |     188
 public     | spgist_text_tbl        |     182
(10 rows)

F.24.3. 作者

Mark Kirkwood

設計協力: Neil Conway

デバッグのアドバイス: Tom Lane