pg_buffercache — проверка состояния кеша буферов QHB

Модуль 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.

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

Определения столбцов, содержащихся в представлении, перечислены в Таблице 3.

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

Столбец ТипОписание
bufferid integerИдентификатор, в диапазоне 1..shared_buffers
relfilenode oid
(ссылается на pg_class.relfilenode)		Номер файлового узла для отношения
reltablespace oid
(ссылается на pg_tablespace.oid)		OID табличного пространства, содержащего отношение
reldatabase oid
(ссылается на pg_database.oid)		OID базы данных, содержащей отношение
relforknumber smallintНомер ветви в отношении; см. common/relpath.h
relblocknumber bigintНомер страницы в отношении
isdirty booleanЭта страница загрязнена?
usagecount smallintСчетчик обращений по часовой стрелке
pinning_backends integerКоличество обслуживающих процессов, закрепивших этот буфер

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

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

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

Функция pg_buffercache_summary()

Определения столбцов, выдаваемых функцией, показаны в Таблице 4.

Таблица 4. Выходные столбцы pg_buffercache_summary()

Столбец ТипОписание
buffers_used int4Количество используемых разделяемых буферов
buffers_unused int4Количество неиспользуемых разделяемых буферов
buffers_dirty int4Количество загрязненных разделяемых буферов
buffers_pinned int4Количество закрепленных разделяемых буферов
usagecount_avg float8Среднее значение счетчиков использования используемых разделяемых буферов

Функция pg_buffercache_summary() возвращает одну строку, кратко характеризующую состояние всех разделяемых буферов. Схожую и более подробную информацию предоставляет представление pg_buffercache, но pg_buffercache_summary() значительно менее затратна.

Как и представление pg_buffercache, функция pg_buffercache_summary() не получает блокировки менеджера буферов. Поэтому параллельная работа может привести к незначительным погрешностям в результате.

Функция pg_buffercache_usage_counts()

Определения столбцов, выдаваемых функцией, показаны в Таблице 5.

Таблица 5. Выходные столбцы pg_buffercache_usage_counts()

Столбец ТипОписание
usage_count int4Возможное значение счетчика использования буферов
buffers int4Количество буферов согласно счетчику использования
dirty int4Количество загрязненных буферов согласно счетчику использования
pinned int4Количество закрепленных буферов согласно счетчику использования

Функция pg_buffercache_usage_counts() возвращает набор строк, кратко характеризующих состояния всех разделяемых буферов, агрегированных по возможным значениям счетчика использования. Схожую и более подробную информацию предоставляет представление pg_buffercache, но pg_buffercache_usage_counts() значительно менее затратна.

Как и представление pg_buffercache, функция pg_buffercache_usage_counts() не получает блокировки менеджера буферов. Поэтому параллельная работа может привести к незначительным погрешностям в результате.

Пример вывода

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)

Авторы

Марк Кирквуд (Mark Kirkwood), markir@paradise.net.nz

Предложения по дизайну: Нейл Конвей (Neil Conway), neilc@samurai.com

Советы по отладке: Том Лейн (Tom Lane), tgl@sss.pgh.pa.us

Copyright © KVANTOM LLC, 2019-2025