pg_buffercache 模块提供了一种手段，可实时检查共享缓冲区缓存中正在发生的情况。 它还提供了一种底层方式，可出于测试目的从中逐出数据。
该模块提供一个 C 函数pg_buffercache_pages，它返回一组记录；另外还提供一个视图pg_buffercache，该视图封装此函数以便使用。
默认情况下，上述函数仅限超级用户以及拥有 pg_monitor 角色权限的角色使用。可以使用 GRANT 将访问权限授予其他角色。
pg_buffercache 视图该视图公开的列定义见 Table F.15。
Table F.15. pg_buffercache 列
| Name | 类型 | 引用 | 描述 |
|---|---|---|---|
bufferid |
integer |
ID，范围为 1..shared_buffers |
|
relfilenode |
oid |
pg_class.relfilenode |
关系的 filenode 编号 |
reltablespace |
oid |
pg_tablespace.oid |
关系的表空间 OID |
reldatabase |
oid |
pg_database.oid |
关系的数据库 OID |
relforknumber |
smallint |
关系中的分支编号；参见include/common/relpath.h |
|
relblocknumber |
bigint |
关系中的页号 | |
isdirty |
boolean |
该页是否为脏页？ | |
usagecount |
smallint |
时钟扫描访问计数 | |
pinning_backends |
integer |
钉住该缓冲区的后端数量 |
共享缓存中的每个缓冲区都有一行记录。未使用的缓冲区除了 bufferid 之外，其余字段均显示为 null。共享系统目录显示为属于数据库 0。
由于缓存由所有数据库共享，其中通常会有不属于当前数据库的关系页。 这意味着某些行在 pg_class 中可能没有可匹配的行， 甚至还可能出现错误的连接结果。如果要与 pg_class 进行连接， 最好将连接限制在 reldatabase 等于当前数据库 OID 或 0 的那些行上。
由于复制该视图将要显示的缓冲区状态数据时不会获取缓冲区管理器锁， 访问 pg_buffercache 视图对正常缓冲区活动的影响较小， 但它不会为所有缓冲区提供一致的结果集。不过，我们会确保每个缓冲区的信息本身是一致的。
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)
Mark Kirkwood <markir@paradise.net.nz>
设计建议： Neil Conway <neilc@samurai.com>
调试建议： Tom Lane <tgl@sss.pgh.pa.us>