9.3 9.4 9.5 9.6 10 11 12 13 14 15 Current(16) 17
问题报告 纠错本页面
F.27. pg_buffercache — 检查PostgreSQL 缓冲区缓存状态
上一页 上一级 附录 F. 附加提供的模块和扩展起始页 下一页

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 <markir@paradise.net.nz>

设计建议: Neil Conway <neilc@samurai.com>

调试建议: Tom Lane <tgl@sss.pgh.pa.us>


上一页 上一级 下一页
F.26. passwordcheck — 验证密码强度 起始页 F.28. pgcrypto — 加密函数

AltStyle によって変換されたページ (->オリジナル) /