F.28. pg_buffercache

F.28.1. Представление pg_buffercache
F.28.2. Пример вывода
F.28.3. Авторы

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

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

By default, use is restricted to superusers and members of the pg_monitor role. Access may be granted to others using GRANT.

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

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

Таблица F.15. Столбцы 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 текущей базы данных или ноль.

Since buffer manager locks are not taken to copy the buffer state data that the view will display, accessing pg_buffercache view has less impact on normal buffer activity but it doesn't provide a consistent set of results across all buffers. However, we ensure that the information of each buffer is self-consistent.

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

Марк Кирквуд

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

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