pg_buffercache

Модуль pg_buffercache предоставляет возможность проверить, что происходит в общем кэше буферов в реальном времени.

Этот модуль предоставляет функцию на C/RUST pg_buffercache_pages, возвращающую набор записей плюс представление pg_buffercache, которое является удобной оберткой этой функции.

По умолчанию его использование разрешено только суперпользователям и членам роли pg_monitor. Дать доступ другим можно с помощью команды GRANT.


Представление pg_buffercache

Определения столбцов, содержащихся в представлении, показаны в Таблице 15.

Таблица 15. Столбцы pg_buffercache

Столбец Тип
Описание
bufferid integer
Идентификатор, в диапазоне 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
Количество обслуживающих процессов, закрепивших этот буфер

Для каждого буфера в общем кэше выдается одна строка. Для неиспользуемых буферов все поля равны NULL, за исключением bufferid. Общие системные каталоги показываются как относящиеся к базе данных номер ноль.

Поскольку кэш используется совместно всеми базами данных, обычно в нем находятся и страницы отношений, не принадлежащих текущей базе данных. Это означает, что для некоторых строк при соединении с pg_class не будет соответствующих строк, или даже могут образоваться некорректные соединения. Если вы пытаетесь выполнить соединение с pg_class, имеет смысл ограничить соединение строками, в которых reldatabase содержит OID текущей базы данных или ноль.

Поскольку для копирования данных состояния буфера, которые будет отображать представление, блокировки в менеджере буферов не устанавливаются, обращения к представлению pg_buffercache оказывает меньшее влияние на нормальную работу буферов, но при этом не обеспечивает согласованный набор результатов для всех буферов. Однако внутри каждого отдельного буфера согласованность информации гарантируется.


Пример вывода

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)

Авторы

Марк Кирквуд (Mark Kirkwood), markir@paradise.net.nz

Предложения по дизайну: Нейл Конвей (Neil Conway), neilc@samurai.com

Советы по отладке: Том Лейн (Tom Lane), tgl@sss.pgh.pa.us