F.33. pg_buffercache

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

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

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

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

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

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

Тип столбца

Описание

bufferidinteger

ID, в диапазоне 1..shared_buffers

relfilenodeoid (ссылается на pg_class.relfilenode)

Номер файлового узла для отношения

reltablespaceoid (ссылается на pg_tablespace.oid)

OID табличного пространства, содержащего отношение

reldatabaseoid (ссылается на pg_database.oid)

OID базы данных, содержащей отношение

relforknumbersmallint

Номер слоя в отношении

relblocknumberbigint

Номер страницы в отношении

isdirtyboolean

Страница загрязнена?

usagecountsmallint

Счётчик обращений по часовой стрелке

pinning_backendsinteger

Число обслуживающих процессов, закрепивших этот буфер


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

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

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

F.33.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.33.3. Авторы

Марк Кирквуд

Предложения по конструкции: Нейл Конвей

Советы по отладке: Том Лейн

close