视图公开的列的定义如 表 F.14 所示。

共享缓存中的每个缓冲区都有一行。未使用的缓冲区显示所有字段为空，除了 bufferid。共享系统目录显示为属于数据库零。

由于缓存由所有数据库共享，因此通常会有不属于当前数据库的关系页面。这意味着某些行可能在 pg_class 中没有匹配的连接行，甚至可能存在不正确的连接。如果您尝试与 pg_class 进行连接，最好将连接限制为 reldatabase 等于当前数据库的 OID 或零的行。

由于没有获取缓冲区管理器锁来复制视图将显示的缓冲区状态数据，因此访问 pg_buffercache 视图对正常缓冲区活动的影响较小，但它不能提供跨所有缓冲区的一致结果。但是，我们确保每个缓冲区的信息是自洽的。

函数公开的列的定义如 表 F.15 所示。

pg_buffercache_summary() 函数返回一个单行，汇总了所有共享缓冲区状态。 pg_buffercache 视图提供了类似且更详细的信息，但 pg_buffercache_summary() 的开销要小得多。

与 pg_buffercache 视图一样，pg_buffercache_summary() 不会获取缓冲区管理器锁。因此，并发活动可能会导致结果出现轻微的不准确。

函数公开的列的定义如 表 F.16 所示。

pg_buffercache_usage_counts() 函数返回一组行，汇总了所有共享缓冲区的状态，并根据可能的使用计数值进行聚合。 pg_buffercache 视图提供了类似且更详细的信息，但 pg_buffercache_usage_counts() 的开销要小得多。

与 pg_buffercache 视图一样，pg_buffercache_usage_counts() 不会获取缓冲区管理器锁。因此，并发活动可能会导致结果出现轻微的不准确。

pg_buffercache_evict() 函数接受一个缓冲区标识符，如 pg_buffercache 视图的 bufferid 列所示。成功时返回 true，如果缓冲区无效、由于被锁定而无法驱逐或在尝试写出后再次变为脏页，则返回 false。由于并发活动，缓冲区可能随时再次变为有效，因此结果在返回后立即过期。该函数仅用于开发人员测试。

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)


regression=# SELECT * FROM pg_buffercache_summary();
 buffers_used | buffers_unused | buffers_dirty | buffers_pinned | usagecount_avg
--------------+----------------+---------------+----------------+----------------
          248 |        2096904 |            39 |              0 |       3.141129
(1 row)


regression=# SELECT * FROM pg_buffercache_usage_counts();
 usage_count | buffers | dirty | pinned
-------------+---------+-------+--------
           0 |   14650 |     0 |      0
           1 |    1436 |   671 |      0
           2 |     102 |    88 |      0
           3 |      23 |    21 |      0
           4 |       9 |     7 |      0
           5 |     164 |   106 |      0
(6 rows)

Mark Kirkwood <markir@paradise.net.nz>

设计建议: Neil Conway <neilc@samurai.com>

调试建议: Tom Lane <tgl@sss.pgh.pa.us>