F.24. pg_buffercache
Модуль pg_buffercache даёт возможность понять, что происходит в общем кеше буферов в реальном времени.
Этот модуль предоставляет функцию на C pg_buffercache_pages, возвращающую набор записей, плюс представление pg_buffercache, которое является удобной обёрткой этой функции.
По умолчанию его использование разрешено только суперпользователям и членам роли pg_monitor. Дать доступ другим можно с помощью GRANT.
F.24.1. Представление pg_buffercache
Определения столбцов, содержащихся в представлении, показаны в Таблице F.15.
Таблица F.15. Столбцы pg_buffercache
| Name | Тип | Ссылки | Описание |
|---|---|---|---|
bufferid | integer | ID, в диапазоне 1..shared_buffers | |
relfilenode | oid | pg_class.relfilenode | Номер файлового узла для отношения |
reltablespace | oid | pg_tablespace.oid | OID табличного пространства, содержащего отношение |
reldatabase | oid | pg_database.oid | 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 меньше сказываются на обычной активности буферов, но набор результатов, полученный для всех буферов, в целом может оказаться несогласованным. Однако внутри каждого отдельного буфера согласованность информации гарантируется.
F.24.2. Пример вывода
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)F.24.3. Авторы
Марк Кирквуд <markir@paradise.net.nz>
Предложения по конструкции: Нейл Конвей <neilc@samurai.com>
Советы по отладке: Том Лейн <tgl@sss.pgh.pa.us>