pg_buffercache 模块提供一种方法，用来检查共享缓冲区高速缓存中正在发生的事情。它还提供一种底层方法来驱逐数据，用于测试目的。
此模块提供 pg_buffercache_pages() 函数（封装在 pg_buffercache 视图中）、pg_buffercache_summary() 函数、pg_buffercache_usage_counts() 函数和 pg_buffercache_evict() 函数。
pg_buffercache_pages() 函数返回一组记录，其中每一行描述一个共享缓冲区项的状态。pg_buffercache 视图会封装函数以方便使用。
pg_buffercache_summary() 函数返回一行，汇总共享缓冲区高速缓存的状态。
pg_buffercache_usage_counts() 函数返回一组记录，其中每一行描述具有给定使用计数的缓冲区的数目。
默认情况下，上述函数的使用仅限于超级用户和具有 pg_monitor 角色特权的角色。可以使用 GRANT 向其他人授予访问权限。
pg_buffercache_evict() 函数允许从缓冲池中驱逐给定缓冲区标识符的块。此函数的使用仅限于超级用户。
pg_buffercache 视图 #视图显示的列的定义显示在 表 F.14 中。
表 F.14. pg_buffercache 列
|
列类型 描述 |
|---|
|
ID，在 1.. |
|
关系的文件节点编号 |
|
关系的表空间 OID |
|
关系的数据库 OID |
|
关系内的 fork 编号；请参见 |
|
关系内的页编号 |
|
页面是否被修改？ |
|
时钟扫描访问计数 |
|
固定此缓冲区的后端数 |
共享缓存中每个缓冲区有一行。未使用的缓冲区显示为所有字段值为空，bufferid 除外。共享系统目录显示为属于数据库零。
由于缓存由所有数据库共享，因此通常会有不属于当前数据库的关系的页面。这意味着在 pg_class 中，某些行可能没有匹配的连接行，或者甚至可能连接错误。如果您尝试与 pg_class 连接，最好将连接限制为将 reldatabase 与当前数据库的 OID 或零相等的行。
由于没有采用缓冲区管理器锁来复制视图将显示的缓冲区状态数据，因此访问 pg_buffercache 视图对正常缓冲区活动的影响较小，但不能提供所有缓冲区的一组一致的结果。但是，我们确保每个缓冲区的信息都是自洽的。
pg_buffercache_summary() 函数 #该函数公开的列的定义显示在 表 F.15 中。
表 F.15. pg_buffercache_summary() 输出列
|
列类型 描述 |
|---|
|
已使用的共享缓冲区数 |
|
未使用共享缓冲区数 |
|
脏共享缓冲区数 |
|
固定共享缓冲区数目 |
|
使用中共享缓冲区的平均使用计数 |
pg_buffercache_summary() 函数返回概括所有共享缓冲区的状态的单行。类似的更详细的信息由 pg_buffercache 视图提供，但 pg_buffercache_summary() 大幅度经济。
类似 pg_buffercache 视图， pg_buffercache_summary() 不获取缓冲区管理器锁定。因此，并发活动可能导致结果中存在细微的不准确。
pg_buffercache_usage_counts() 函数 #该函数公开的列定义在 表 F.16 中展示。
表 F.16. pg_buffercache_usage_counts() 输出列
|
列类型 描述 |
|---|
|
可能的缓冲区使用计数 |
|
带有此使用计数的缓冲区数目 |
|
带有此使用计数的脏缓冲区数目 |
|
带有此使用计数的固定缓冲区数目 |
pg_buffercache_usage_counts() 函数返回一组关于所有共享缓冲区状态的总结性行，汇总为可能的用法计数值。 pg_buffercache 视图提供了类似的更详细的信息，但 pg_buffercache_usage_counts() 明显更加经济。
类似 pg_buffercache 视图， pg_buffercache_usage_counts() 不获取缓冲区管理器锁定。因此，并发活动可能导致结果中略有偏差。
pg_buffercache_evict 函数 #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 <[email protected]>
设计建议：Neil Conway <[email protected]>
调试建议：Tom Lane <[email protected]>