2024 年 9 月 26 日:PostgreSQL 17 发布!
支持的版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不支持的版本:11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3

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. The pg_buffercache 视图 #

视图公开的列的定义在 表 F.14 中显示。

表 F.14. pg_buffercache

列 类型

描述

bufferid integer

ID,在 1..shared_buffers 范围内

relfilenode oid(引用 pg_class.relfilenode

关系的 Filenode 编号

reltablespace oid(引用 pg_tablespace.oid

关系的表空间 OID

reldatabase oid(引用 pg_database.oid

关系的数据库 OID

relforknumber smallint

关系中的分叉编号;请参阅 common/relpath.h

relblocknumber bigint

关系中的页编号

isdirty boolean

该页是否脏?

usagecount smallint

时钟扫描访问计数

pinning_backends integer

锁定此缓冲区的后端数量


共享缓存中的每个缓冲区都有一行。未使用的缓冲区显示的所有字段都为 NULL,除了 bufferid。共享系统目录显示为属于数据库零。

由于缓存由所有数据库共享,因此通常会有来自不属于当前数据库的关系的页面。这意味着可能在某些行中找不到 pg_class 中的匹配连接行,甚至可能存在不正确的连接。如果您尝试连接到 pg_class,最好将连接限制为具有 reldatabase 等于当前数据库 OID 或零的行。

由于不会获取缓冲区管理器锁来复制视图将显示的缓冲区状态数据,因此访问 pg_buffercache 视图对正常的缓冲区活动影响较小,但它不会提供跨所有缓冲区一致的结果集。但是,我们确保每个缓冲区的信息都是自一致的。

F.25.2. The pg_buffercache_summary() 函数 #

函数公开的列的定义在 表 F.15 中显示。

表 F.15. pg_buffercache_summary() 输出列

列 类型

描述

buffers_used int4

已使用共享缓冲区的数量

buffers_unused int4

未使用的共享缓冲区的数量

buffers_dirty int4

脏共享缓冲区的数量

buffers_pinned int4

锁定共享缓冲区的数量

usagecount_avg float8

已使用共享缓冲区的平均使用计数


pg_buffercache_summary() 函数返回一行,总结所有共享缓冲区的状态。 pg_buffercache 视图提供了类似且更详细的信息,但 pg_buffercache_summary() 的成本明显更低。

pg_buffercache 视图类似,pg_buffercache_summary() 不会获取缓冲区管理器锁。因此,并发活动会导致结果出现轻微的不准确。

F.25.3. The pg_buffercache_usage_counts() 函数 #

函数公开的列的定义在 表 F.16 中显示。

表 F.16. pg_buffercache_usage_counts() 输出列

列 类型

描述

usage_count int4

可能的缓冲区使用计数

buffers int4

具有该使用计数的缓冲区数量

dirty int4

具有该使用计数的脏缓冲区数量

pinned int4

具有该使用计数的锁定缓冲区数量


pg_buffercache_usage_counts() 函数返回一组行,总结所有共享缓冲区的状态,并按可能的用法计数值进行聚合。 pg_buffercache 视图提供了类似且更详细的信息,但 pg_buffercache_usage_counts() 的成本明显更低。

pg_buffercache 视图类似,pg_buffercache_usage_counts() 不会获取缓冲区管理器锁。因此,并发活动会导致结果出现轻微的不准确。

F.25.4. The 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

设计建议:Neil Conway

调试建议:Tom Lane

提交更正

如果您在文档中发现任何不正确的内容,与您对特定功能的体验不符或需要进一步说明,请使用 此表格 报告文档问题。