↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3

F.27. pg_buffercache #

pg_buffercache 模块提供了一种手段,可实时检查共享缓冲区缓存中正在发生的情况。

该模块提供一个 C 函数 pg_buffercache_pages,它返回一组记录;另外还提供一个视图 pg_buffercache,该视图封装此函数以便使用。

默认情况下,仅限超级用户以及具有 pg_monitor 角色权限的角色使用。可以使用 GRANT 将访问权限授予其他角色。

F.27.1. pg_buffercache 视图 #

该视图公开的列定义见表 F.15。

表 F.15. pg_buffercache 列

列类型

描述

bufferid integer

ID,范围为 1..shared_buffers

relfilenode oid(引用 pg_class.relfilenode)

关系的文件节点编号

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

钉住该缓冲区的后端数量


共享缓存中的每个缓冲区都有一行记录。未使用的缓冲区除了 bufferid 之外,其余字段均显示为 null。共享系统目录显示为属于数据库 0。

由于缓存由所有数据库共享,其中通常会有不属于当前数据库的关系页。这意味着某些行在 pg_class 中可能没有可匹配的行,甚至还可能出现错误的连接结果。如果要与 pg_class 进行连接,最好将连接限制在 reldatabase 等于当前数据库 OID 或 0 的那些行上。

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

F.27.2. 示例输出 #

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)

F.27.3. 作者 #

Mark Kirkwood

设计建议:Neil Conway

调试建议:Tom Lane

报告文档问题

阅读 上游文档. 通过 PostgreSQL 文档反馈表单.