F.27. pg_buffercache — информация о состоянии буферного кеша PostgreSQL #
Модуль pg_buffercache
даёт возможность понять, что происходит в общем кеше буферов в реальном времени.
Этот модуль предоставляет функцию pg_buffercache_pages()
(обёрнута в представление pg_buffercache
), а также функции pg_buffercache_summary()
и pg_buffercache_usage_counts()
.
Функция pg_buffercache_pages()
возвращает набор записей, каждая строка которого описывает состояние одного буфера в общем кеше. Для удобства пользования обёрткой функции является представление pg_buffercache
.
Функция pg_buffercache_summary()
возвращает одну строку со сводной информацией о состоянии общего кеша буферов.
Функция pg_buffercache_usage_counts()
возвращает набор записей, в каждой строке которого указано количество буферов в разбивке по счётчику использования.
По умолчанию его использование разрешено только суперпользователям и ролям с правами роли pg_monitor
. Дать доступ другим можно с помощью GRANT
.
F.27.1. Представление pg_buffercache
#
Определения столбцов, содержащихся в представлении, показаны в Таблице F.15.
Таблица F.15. Столбцы pg_buffercache
Тип столбца Описание |
---|
ID, в диапазоне 1.. |
Номер файлового узла для отношения |
OID табличного пространства, содержащего отношение |
OID базы данных, содержащей отношение |
Номер слоя в отношении; см. |
Номер страницы в отношении |
Страница загрязнена? |
Счётчик обращений по часовой стрелке |
Число обслуживающих процессов, закрепивших этот буфер |
Для каждого буфера в общем кеше выдаётся одна строка. Для неиспользуемых буферов все поля равны NULL, за исключением bufferid
. Общие системные каталоги показываются как относящиеся к базе данных под номером 0.
Так как кеш используется совместно всеми базами данных, обычно в нём находятся и страницы из отношений, не принадлежащих текущей базе данных. Это означает, что для некоторых строк при соединении с pg_class
не найдутся соответствующие строки, либо соединение будет некорректным. Если вы хотите выполнить соединение с pg_class
, будет правильным ограничить соединение строками, в которых reldatabase
содержит OID текущей базы данных или ноль.
Для копирования данных состояния, которые будут отображаться, блокировки в менеджере буферов не устанавливаются. Поэтому обращения к представлению pg_buffercache
меньше сказываются на обычной активности буферов, но набор результатов, полученный для всех буферов, в целом может оказаться несогласованным. Однако внутри каждого отдельного буфера согласованность информации гарантируется.
F.27.2. Функция pg_buffercache_summary()
#
Определения столбцов, возвращаемых функцией, показаны в Таблице F.16.
Таблица F.16. Выходные столбцы pg_buffercache_summary()
Тип столбца Описание |
---|
Число используемых общих буферов |
Число неиспользуемых общих буферов |
Число загрязнённых общих буферов |
Число закреплённых общих буферов |
Среднее значение счётчика использования общих буферов |
Функция pg_buffercache_summary()
возвращает одну строку со сводной информацией о состоянии всех общих буферов. Подобную и более подробную информацию можно получить из представления pg_buffercache
, но pg_buffercache_summary()
обходится существенно дешевле.
Как и представление pg_buffercache
, pg_buffercache_summary()
не получает блокировки менеджера буферов, поэтому при параллельной работе в базе данных допустима незначительная погрешность результатов функции.
F.27.3. Функция pg_buffercache_usage_counts()
#
Определения столбцов, возвращаемых функцией, показаны в Таблице F.17.
Таблица F.17. Выходные столбцы pg_buffercache_usage_counts()
Тип столбца Описание |
---|
Возможное значение счётчика использования буферов |
Число буферов в разбивке по счётчику использования |
Число загрязнённых буферов в разбивке по счётчику использования |
Число закреплённых буферов в разбивке по счётчику использования |
Функция pg_buffercache_usage_counts()
возвращает набор строк со сводной информацией о состоянии всех общих буферов, агрегированных по возможным значениям счётчика использования. Подобную и более подробную информацию можно получить с помощью представления pg_buffercache
, но pg_buffercache_usage_counts()
обходится существенно дешевле.
Как и представление pg_buffercache
, pg_buffercache_usage_counts()
не получает блокировки менеджера буферов, поэтому при параллельной работе в базе данных допустима незначительная погрешность результатов функции.
F.27.4. Пример вывода #
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) regression=# SELECT * FROM pg_buffercache_summary(); buffers_used | buffers_unused | buffers_dirty | buffers_pinned | usagecount_avg --------------+----------------+---------------+----------------+---------------- 248 | 2096904 | 39 | 0 | 3.141129 (1 row) regression=# SELECT * FROM pg_buffercache_usage_counts(); usage_count | buffers | dirty | pinned -------------+---------+-------+-------- 0 | 14650 | 0 | 0 1 | 1436 | 671 | 0 2 | 102 | 88 | 0 3 | 23 | 21 | 0 4 | 9 | 7 | 0 5 | 164 | 106 | 0 (6 rows)
F.27.5. Авторы #
Марк Кирквуд <markir@paradise.net.nz>
Предложения по конструкции: Нейл Конвей <neilc@samurai.com>
Советы по отладке: Том Лейн <tgl@sss.pgh.pa.us>