pg_buffercache 模块提供了一种实时检查共享缓冲区缓存状态的方法。它还提供了一种低级方式，用于出于测试目的将数据从缓存中驱逐出去。
此模块提供了 pg_buffercache_pages() 函数（包装在 pg_buffercache 视图中）、pg_buffercache_numa_pages() 函数（包装在 pg_buffercache_numa 视图中）、pg_buffercache_summary() 函数、pg_buffercache_usage_counts() 函数、pg_buffercache_evict() 函数、pg_buffercache_evict_relation() 函数和 pg_buffercache_evict_all() 函数。
pg_buffercache_pages() 函数返回一组记录，每行描述一个共享缓冲区条目的状态。pg_buffercache 视图包装了该函数，以便于使用。
pg_buffercache_numa_pages() 函数提供NUMA共享缓冲区条目的节点映射。此信息不包含在 pg_buffercache_pages() 函数本身中，因为它检索起来要慢得多。pg_buffercache_numa 视图包装了该函数，以便于使用。
pg_buffercache_summary() 函数返回一个单行，总结了共享缓冲区缓存的状态。
pg_buffercache_usage_counts() 函数返回一组记录，每行描述具有给定使用计数的缓冲区的数量。
默认情况下，上述函数的用法仅限于超级用户以及具有 pg_monitor 角色权限的角色。可以使用 GRANT 将访问权限授予其他人。
pg_buffercache_evict() 函数允许给定缓冲区标识符的块从缓冲区池中驱逐出去。此函数的使用仅限于超级用户。
pg_buffercache_evict_relation() 函数允许给定关系标识符的所有未锁定（unpinned）的共享缓冲区从缓冲区池中驱逐出去。此函数的使用仅限于超级用户。
pg_buffercache_evict_all() 函数允许将缓冲区池中的所有未锁定（unpinned）的共享缓冲区驱逐出去。此函数的使用仅限于超级用户。
pg_buffercache View #视图公开的列的定义显示在 表 F.14 中。
表 F.14. pg_buffercache 列
|
列 类型 描述 |
|---|
|
ID，范围为 1.. |
|
关系的文件节点号 |
|
关系的表空间 OID |
|
关系的数据库 OID |
|
关系内的分叉号；参见 |
|
关系内的页面号 |
|
页面是否脏？ |
|
时钟扫描访问计数 |
|
固定此缓冲区的后端数量 |
共享缓存中的每个缓冲区都有一行。未使用的缓冲区显示除 bufferid 之外的所有字段都为 NULL。共享系统目录显示为属于数据库零。
由于缓存被所有数据库共享，因此通常会有来自不属于当前数据库的关系的页面。这意味着 pg_class 中可能没有匹配的连接行，或者甚至可能存在不正确的连接。如果您尝试连接到 pg_class，最好将连接限制为 reldatabase 等于当前数据库 OID 或零的行。
由于在复制视图将要显示的缓冲区状态数据时不会获取缓冲区管理器锁，因此访问 pg_buffercache 视图对正常的缓冲区活动影响较小，但它无法为所有缓冲区提供一致的结果集。但是，我们确保每个缓冲区的信息都是自洽的。
pg_buffercache_numa View #视图公开的列的定义显示在 表 F.15 中。
表 F.15. pg_buffercache_numa 列
|
列 类型 描述 |
|---|
|
ID，范围为 1.. |
|
此缓冲区的操作系统内存页数 |
|
ID ofNUMA节点 |
作为NUMA节点 ID 查询每个页面需要将内存页面分页，第一次执行此函数可能需要明显的时间。在所有情况下（第一次执行或不是），检索此信息都非常昂贵，因此不建议频繁查询此视图。
在确定NUMA节点时，视图会触及共享内存段的所有内存页。这将强制分配共享内存（如果尚未分配），并且内存可能会分配在单个NUMA节点上（取决于系统配置）。
pg_buffercache_summary() Function #函数公开的列的定义显示在 表 F.16 中。
表 F.16. pg_buffercache_summary() 输出列
|
列 类型 描述 |
|---|
|
使用的共享缓冲区数量 |
|
未使用的共享缓冲区数量 |
|
脏共享缓冲区数量 |
|
锁定的共享缓冲区数量 |
|
已用共享缓冲区的平均使用计数 |
pg_buffercache_summary() 函数返回一个单行，总结了所有共享缓冲区状态。 pg_buffercache 视图提供了相似且更详细的信息，但 pg_buffercache_summary() 的开销要小得多。
与 pg_buffercache 视图一样，pg_buffercache_summary() 不会获取缓冲区管理器锁。因此，并发活动可能导致结果存在细微的错误。
pg_buffercache_usage_counts() Function #函数公开的列的定义显示在 表 F.17 中。
表 F.17. pg_buffercache_usage_counts() 输出列
|
列 类型 描述 |
|---|
|
可能的缓冲区使用计数 |
|
具有该使用计数的缓冲区数量 |
|
具有该使用计数的脏缓冲区数量 |
|
具有该使用计数的锁定缓冲区数量 |
pg_buffercache_usage_counts() 函数返回一组行，总结了所有共享缓冲区的状态，并按可能的使用计数进行汇总。pg_buffercache 视图提供了相似且更详细的信息，但 pg_buffercache_usage_counts() 的开销要小得多。
与 pg_buffercache 视图一样，pg_buffercache_usage_counts() 不会获取缓冲区管理器锁。因此，并发活动可能导致结果存在细微的错误。
pg_buffercache_evict() Function #pg_buffercache_evict() 函数接受一个缓冲区标识符，如 pg_buffercache 视图的 bufferid 列所示。它返回有关缓冲区是否被驱逐和刷新（flushed）的信息。如果缓冲区无效、由于被锁定而无法驱逐，或者在尝试写出后又变脏，则 列为 true。这并不一定意味着缓冲区是由我们刷新的，它可能由其他人刷新。由于并发活动，缓冲区可能随时再次变有效，因此结果在返回后立即过时。该函数仅用于开发人员测试。
pg_buffercache_evict_relation() Function #pg_buffercache_evict_relation() 函数与 pg_buffercache_evict() 函数非常相似。区别在于 pg_buffercache_evict_relation() 接受一个关系标识符而不是缓冲区标识符。它会尝试驱逐该关系所有分叉（forks）的所有缓冲区。它返回被驱逐的缓冲区数量、被刷新的缓冲区数量以及无法被驱逐的缓冲区数量。被刷新的缓冲区不一定是由我们刷新的，它们可能由其他人刷新。由于并发活动，缓冲区可能立即被重新读入，因此结果在返回后立即过时。该函数仅用于开发人员测试。
pg_buffercache_evict_all() Function #pg_buffercache_evict_all() 函数与 pg_buffercache_evict() 函数非常相似。区别在于，pg_buffercache_evict_all() 函数不接受参数；而是尝试驱逐缓冲区池中的所有缓冲区。它返回被驱逐的缓冲区数量、被刷新的缓冲区数量以及无法被驱逐的缓冲区数量。被刷新的缓冲区不一定是由我们刷新的，它们可能由其他人刷新。由于并发活动，缓冲区可能立即被重新读入，因此结果在返回后立即过时。该函数仅用于开发人员测试。
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>
如果您在文档中看到任何不正确、与您在该特定功能上的体验不符或需要进一步澄清的内容，请使用 此表格 报告文档问题。