pg_buffercache. Проверка состояния общего кеша буферов в реальном времени#

В исходном дистрибутиве установлено по умолчанию: нет.

Связанные компоненты: отсутствуют.

Схема размещения: ext.

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

Модуль предоставляет:

pg_buffercache_pages – функцию на C, возвращающую набор записей.
pg_buffercache – обертка функции pg_buffercache_pages.

Столбцы представления pg_buffercache:

Имя столбца	Тип	Описание
`bufferid`	`integer`	`ID` в диапазоне [`1`…`shared_buffers`]
`relfilenode`	`oid`	Номер файлового узла для отношения. `oid` ссылается на `pg_class.relfilenode`
`reltablespace`	`oid`	OID содержащего отношение табличного пространства. `oid` ссылается на `pg_tablespace.oid`
`reldatabase`	`oid`	OID базы данных, содержащей отношение. `oid` ссылается на `pg_database.oid`
`relforknumber`	`smallint`	Номер слоя в отношении; см. include/common/relpath.h
`relblocknumber`	`bigint`	Номер страницы в отношении
`isdirty`	`boolean`	Загрязнена ли страница
`usagecount`	`smallint`	Счетчик обращений по часовой стрелке
`pinning_backends`	`integer`	Число обслуживающих процессов, закрепивших этот буфер

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

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

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

Доработка#

Доработка не проводилась.

Ограничения#

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

Установка#

При наличии прав администратора СУБД включение модуля выполняется запросом:

CREATE EXTENSION pg_buffercache SCHEMA ext;

Настройка#

Настройка не требуется.

Использование модуля#

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 
------------+----------------+---------
 pg_catalog | pg_proc        |     136
 pg_catalog | pg_attribute   |     106
 pg_catalog | pg_depend      |      71
 pg_toast   | pg_toast_2618  |      60
 pg_catalog | pg_collation   |      52
 pg_catalog | pg_description |      39
 pg_catalog | pg_operator    |      22
 pg_catalog | pg_class       |      18
 pg_catalog | pg_statistic   |      18
 pg_catalog | pg_rewrite     |      16
(10 rows)

Ссылки на документацию разработчика#

Дополнительно поставляемый модуль pg_buffercache: https://www.postgresql.org/docs/15/pgbuffercache.html