pg_buffercache — просмотр состояния буферного кеша PostgreSQL#

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

Этот модуль предоставляет функцию pg_buffercache_pages(), обернутую во представление pg_buffercache, а также функции pg_buffercache_summary(), pg_buffercache_usage_counts() и pg_buffercache_evict().

Функция pg_buffercache_pages() возвращает набор записей, каждая строка описывает состояние одной записи общего буфера. Представление pg_buffercache упрощает использование этой функции.

Функция pg_buffercache_summary() возвращает одну строку, обобщающую состояние общего буферного кеша.

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

По умолчанию доступ к этим функциям ограничен суперпользователями и ролями с привилегиями роли pg_monitor. Доступ может быть предоставлен другим пользователям с помощью команды GRANT.

Функция pg_buffercache_evict() позволяет вытеснить блок из пула буферов по идентификатору буфера. Использование данной функции ограничено только суперпользователями.

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

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

Столбцы pg_buffercache:

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

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

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

Функция pg_buffercache_summary()#

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

Столбцы вывода pg_buffercache_summary():

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

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

Функция pg_buffercache_usage_counts()#

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

Столбцы вывода pg_buffercache_usage_counts():

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

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

Функция pg_buffercache_evict()#

Функция pg_buffercache_evict() принимает идентификатор буфера, указанный в столбце bufferid представления pg_buffercache. Она возвращает значение true при успешном выполнении и false, если буфер был недействительным, его нельзя было вытеснить из-за того, что он был закреплен, или он снова стал грязным после попытки записи. Результат сразу устареет после возврата, так как буфер может стать действительным в любой момент времени из-за параллельной активности. Эта функция предназначена исключительно для тестирования разработчиками.

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

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)