F.33. pg_buffercache

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

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

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

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

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

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

ИмяТипСсылкиОписание
bufferidinteger ID, в диапазоне 1..shared_buffers
relfilenodeoidpg_class.relfilenodeНомер файлового узла для отношения
reltablespaceoidpg_tablespace.oidOID табличного пространства, содержащего отношение
reldatabaseoidpg_database.oidOID базы данных, содержащей отношение
relforknumbersmallint Номер слоя в отношении; см. include/common/relpath.h
relblocknumberbigint Номер страницы в отношении
isdirtyboolean Страница загрязнена?
usagecountsmallint Счётчик обращений по часовой стрелке
pinning_backendsinteger Число обслуживающих процессов, закрепивших этот буфер

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

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

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

F.33.2. Пример вывода

regression=# SELECT c.relname, count(*) AS buffers
             FROM pg_buffercache b INNER 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()))
             GROUP BY c.relname
             ORDER BY 2 DESC
             LIMIT 10;

             relname             | buffers
---------------------------------+---------
 tenk2                           |     345
 tenk1                           |     141
 pg_proc                         |      46
 pg_class                        |      45
 pg_attribute                    |      43
 pg_class_relname_nsp_index      |      30
 pg_proc_proname_args_nsp_index  |      28
 pg_attribute_relid_attnam_index |      26
 pg_depend                       |      22
 pg_depend_reference_index       |      20
(10 rows)

F.33.3. Авторы

Марк Кирквуд

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

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