9.3 9.4 9.5 9.6 10 11 12 13 14 15 Current(16) 17
问题报告 纠错本页面

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

列类型

描述

bufferid integer

ID,在范围 1..shared_buffers

relfilenode oid (references pg_class.relfilenode)

关系的文件结点编号

reltablespace oid (references pg_tablespace.oid)

关系的表空间 OID

reldatabase oid (references pg_database.oid)

关系的数据库 OID

relforknumber smallint

关系内的分叉数,见common/relpath.h

relblocknumber bigint

关系内的页面数

isdirty boolean

页面是否为脏?

usagecount smallint

Clock-sweep 访问计数

pinning_backends integer

对这个缓冲区加 pin 的后端数量


共享缓存中的每一个缓冲区都有一行。没有使用的缓冲区的行中只有bufferid为非空。共享的系统目录被显示为属于数据库零。

因为缓冲是所有数据库共享的,通常会有不属于当前数据库的关系的页面。这意味着对于一些行在pg_class中可能不会有匹配的连接行,或者甚至有错误的连接。如果你试图与pg_class连接,将连接限制于reldatabase等于当前数据库 OID 或零的行是一个好主意。

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

F.27.2. 函数pg_buffercache_summary()的功能 #

函数所显示列的定义如表 F.16中所示。

表 F.16. 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.27.3. 函数pg_buffercache_usage_counts()的功能 #

函数所暴露的列的定义如 表 F.17中所示。

表 F.17. 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.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

设计建议: Neil Conway

调试建议: Tom Lane