登录F.27. pg_buffercache — 检查PostgreSQL缓冲区高速缓存状态#
- F.27.1.
pg_buffercache视图 - F.27.2.
pg_buffercache_summary()函数 - F.27.3.
pg_buffercache_usage_counts()函数 - F.27.4. 样例输出
- F.27.5. 作者
pg_buffercache模块提供了一种方法，用于实时检查共享缓冲区高速缓存中发生的情况。
此模块提供pg_buffercache_pages()函数（包装在pg_buffercache视图中）、pg_buffercache_summary()函数和pg_buffercache_usage_counts()函数。
pg_buffercache_pages()函数返回一组记录，每行描述一个共享缓冲区条目的状态。pg_buffercache视图包装该函数以方便使用。
pg_buffercache_summary()函数返回一行，总结共享缓冲区高速缓存的状态。
pg_buffercache_usage_counts()函数返回一组记录，每行描述具有给定使用计数的缓冲区数。
默认情况下，仅限超级用户和具有pg_monitor角色权限的角色使用。可以使用GRANT向其他人授予访问权限。
F.27.1.pg_buffercache视图#
视图公开的列的定义显示在表 F.15中。
表 F.15.pg_buffercache列
列类型 说明 |
|---|
ID，范围为 1.. |
关系的文件节点号 |
关系的表空间 OID |
关系的数据库 OID |
关系内的 Fork 号；请参见 |
关系内的页号 |
该页是否已修改？ |
时钟扫描访问计数 |
固定此缓冲区的后端数量 |
共享缓存中每个缓冲区有一行。未使用的缓冲区显示为所有字段为空，除了bufferid。共享系统目录显示为属于数据库零。
由于该缓存由所有数据库共享，因此通常会有不属于当前数据库的关系的页面。这意味着在pg_class中，某些行可能没有匹配的联接行，甚至可能存在不正确的联接。如果您尝试与pg_class联接，最好将联接限制为reldatabase等于当前数据库的 OID 或零的行。
由于未获取缓冲区管理器锁来复制视图将显示的缓冲区状态数据，因此访问pg_buffercache视图对正常缓冲区活动的影响较小，但它不会提供所有缓冲区的一致结果集。但是，我们确保每个缓冲区的信息都是自洽的。
F.27.2.pg_buffercache_summary()函数#
该函数公开的列的定义显示在表 F.16中。
表 F.16.pg_buffercache_summary()输出列
列类型 说明 |
|---|
已使用的共享缓冲区数量 |
未使用的共享缓冲区数量 |
脏共享缓冲区数量 |
已固定的共享缓冲区数量 |
已使用共享缓冲区的平均使用计数 |
pg_buffercache_summary()函数返回一行，总结所有共享缓冲区的状态。类似且更详细的信息由pg_buffercache视图提供，但pg_buffercache_summary()的成本要低得多。
与pg_buffercache视图一样，pg_buffercache_summary()不会获取缓冲区管理器锁。因此，并发活动可能导致结果出现轻微不准确。
F.27.3.pg_buffercache_usage_counts()函数#
函数公开的列的定义显示在表 F.17中。
表 F.17.pg_buffercache_usage_counts()输出列
列类型 说明 |
|---|
可能的缓冲区使用计数 |
使用计数的缓冲区数量 |
使用计数的脏缓冲区数量 |
使用计数的固定缓冲区数量 |
pg_buffercache_usage_counts()函数返回一组行，总结所有共享缓冲区的状态，汇总可能的用法计数值。类似且更详细的信息由pg_buffercache视图提供，但pg_buffercache_usage_counts()的成本要低得多。
与pg_buffercache视图一样，pg_buffercache_usage_counts()不会获取缓冲区管理器锁。因此，并发活动可能会导致结果出现轻微的不准确性。
F.27.4. 样本输出#
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.27.5. 作者#
Mark Kirkwood<[[email protected]](/cdn-cgi/l/email-protection#e78a86958c8e95a797869586838e9482c9898293c9899d)>
设计建议：Neil Conway<[[email protected]](/cdn-cgi/l/email-protection#701e15191c133003111d050211195e131f1d)>
调试建议：Tom Lane<[[email protected]](/cdn-cgi/l/email-protection#5226353e122121217c22353a7c22337c2721)>