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
视图 #视图显示的列的定义如Table F.14所示。
Table F.14. pg_buffercache
列
列类型 描述 |
---|
ID,在范围 1.. |
关系的文件结点编号 |
关系的表空间 OID |
关系的数据库 OID |
关系内的分叉数,见 |
关系内的页面数 |
页面是否为脏? |
Clock-sweep 访问计数 |
对这个缓冲区加 pin 的后端数量 |
共享缓存中的每一个缓冲区都有一行。没有使用的缓冲区的行中只有bufferid
为非空。共享的系统目录被显示为属于数据库零。
因为缓冲是所有数据库共享的,通常会有不属于当前数据库的关系的页面。这意味着对于一些行在pg_class
中可能不会有匹配的连接行,或者甚至有错误的连接。如果你试图与pg_class
连接,将连接限制于reldatabase
等于当前数据库 OID 或零的行是一个好主意。
由于缓冲区管理器锁不会用于复制视图将显示的缓冲区状态数据,因此访问pg_buffercache
视图对正常缓冲区活动的影响较小,但它不会在所有缓冲区中提供一致的结果集。但是,我们确保每个缓冲区的信息是自洽的。
pg_buffercache_summary()
的功能 #函数所显示列的定义如Table F.15中所示。
Table F.15. pg_buffercache_summary()
输出列
列类型 描述 |
---|
使用的共享缓冲区数量 |
未使用的共享缓冲区数量 |
脏共享缓冲区的数量 |
被固定的共享缓冲区的数量 |
已使用共享缓冲区的平均使用计数 |
pg_buffercache_summary()
函数返回一行摘要,概述所有共享缓冲区的状态。
类似且更详细的信息由 pg_buffercache
视图提供,但
pg_buffercache_summary()
的开销显著更低。
与pg_buffercache
视图类似,
pg_buffercache_summary()
不会获取缓冲区管理器锁。
因此,并发活动可能会导致结果出现轻微的不准确。
pg_buffercache_usage_counts()
的功能 #函数所暴露的列的定义如 Table F.16中所示。
Table 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()
函数接受一个缓冲区标识符,
如 bufferid
列在 pg_buffercache
视图中所示。
它在成功时返回 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>