F.27. pg_buffercache
Модуль pg_buffercache
даёт возможность понять, что происходит в общем кеше буферов в реальном времени.
Этот модуль предоставляет функцию на C pg_buffercache_pages
, возвращающую набор записей, плюс представление pg_buffercache
, которое является удобной обёрткой этой функции.
По умолчанию, роли public на всякий случай, во избежание угрозы безопасности, запрещён любой доступ к этим объектам.
F.27.1. Представление pg_buffercache
Определения столбцов, содержащихся в представлении, показаны в Таблице F.17.
Таблица F.17. Столбцы pg_buffercache
Имя | Тип | Ссылки | Описание |
---|---|---|---|
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.27.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.27.3. Авторы
Марк Кирквуд <markir@paradise.net.nz>
Предложения по конструкции: Нейл Конвей <neilc@samurai.com>
Советы по отладке: Том Лейн <tgl@sss.pgh.pa.us>