F.25. pg_buffercache — 检查 PostgreSQL 缓冲区缓存状态 #
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() 函数允许根据给定的缓冲区标识符,从缓冲池中逐出一个块。该函数仅限超级用户使用。
F.25.1. pg_buffercache 视图 #
该视图公开的列定义见表 F.14。
表 F.14. pg_buffercache 列
列类型 描述 |
|---|
ID,范围为 1.. |
关系的文件节点编号 |
关系的表空间 OID |
关系的数据库 OID |
关系中的分支编号;见
|
关系中的页号 |
该页是否为脏页? |
时钟扫描访问计数 |
钉住该缓冲区的后端数量 |
共享缓存中的每个缓冲区都有一行记录。未使用的缓冲区除了
bufferid 之外,其余字段均显示为 null。共享系统目录显示为属于数据库 0。
由于缓存由所有数据库共享,其中通常会有不属于当前数据库的关系页。这意味着某些行在 pg_class 中可能没有可匹配的行,甚至还可能出现错误的连接结果。如果要与 pg_class 进行连接,最好将连接限制在 reldatabase 等于当前数据库 OID 或 0 的那些行上。
由于复制该视图将要显示的缓冲区状态数据时不会获取缓冲区管理器锁,访问 pg_buffercache 视图对正常缓冲区活动的影响较小,但它不会为所有缓冲区提供一致的结果集。不过,我们会确保每个缓冲区的信息本身是一致的。
F.25.2. pg_buffercache_summary() 函数 #
该函数公开的列定义见表 F.15。
表 F.15. pg_buffercache_summary() 输出列
列类型 描述 |
|---|
已使用的共享缓冲区数量 |
未使用的共享缓冲区数量 |
脏共享缓冲区的数量 |
被钉住的共享缓冲区数量 |
已使用共享缓冲区的平均使用计数 |
pg_buffercache_summary() 函数返回一行,汇总所有共享缓冲区的状态。类似且更详细的信息由
pg_buffercache 视图提供,但
pg_buffercache_summary() 的开销显著更低。
与 pg_buffercache 视图一样,pg_buffercache_summary() 不获取缓冲区管理器锁。因此,并发活动可能导致结果存在轻微误差。
F.25.3. 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() 不获取缓冲区管理器锁。因此,并发活动可能导致结果存在轻微误差。
F.25.4. pg_buffercache_evict() 函数 #
pg_buffercache_evict() 函数接受一个缓冲区标识符,如 pg_buffercache 视图的
bufferid 列所示。成功时返回 true;如果该缓冲区无效、因被钉住而无法逐出,或者在尝试将其写出后又重新变脏,则返回 false。由于并发活动,该函数返回时结果立即就会过时,因为该缓冲区随时可能再次变为有效。该函数仅供开发人员测试。
F.25.5. 示例输出 #
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)
F.25.6. 作者 #
Mark Kirkwood <markir@paradise.net.nz>
设计建议:Neil Conway <neilc@samurai.com>
调试建议:Tom Lane <tgl@sss.pgh.pa.us>
报告文档问题
阅读 上游文档. 通过 PostgreSQL 文档反馈表单.