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

F.25. pg_buffercache — 检查PostgreSQL 缓冲区缓存状态 #

F.25.1. pg_buffercache视图
F.25.2. 函数pg_buffercache_summary()的功能
F.25.3. 函数pg_buffercache_usage_counts()的功能
F.25.4. pg_buffercache_evict() 函数
F.25.5. 样例输出
F.25.6. 作者

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

视图显示的列的定义如Table F.14所示。

Table F.14. 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.25.2. 函数pg_buffercache_summary()的功能 #

函数所显示列的定义如Table F.15中所示。

Table 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. 函数pg_buffercache_usage_counts()的功能 #

函数所暴露的列的定义如 Table F.16中所示。

Table 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. pg_buffercache_evict() 函数 #

pg_buffercache_evict() 函数接受一个缓冲区标识符, 如 bufferid 列在 pg_buffercache 视图中所示。 它在成功时返回 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