pg_buffercache — просмотр состояния буферного кеша PostgreSQL
Эта страница переведена при помощи нейросети GigaChat.
Модуль 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:
| Тип столбца | Описание |
|---|---|
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 | Номер слоя внутри отношения, см. common/relpath.h |
relblocknumber bigint | Номер страницы в отношении |
isdirty boolean | Страница загрязнена? |
usagecount smallint | Счетчик обращений по часовой стрелке |
pinning_backends integer | Количество обслуживающих процессов, закрепивших этот буфер |
Для каждого буфера в общем кеше выдается одна строка. Для неиспользуемых буферов все поля равны NULL, за исключением bufferid. Общие системные каталоги отображаются как принадлежащие базе данных с номером ноль.
Поскольку кеш используется всеми базами данных, обычно в нем будут и страницы из отношений, не принадлежащих текущей базе данных. Это означает, что для некоторых строк может не быть соответствующих строк соединения в pg_class или даже могут быть неправильные соединения. Если требуется присоединиться к pg_class, то хорошей идеей будет ограничить соединение строками, у которых reldatabase равно идентификатору текущей базы данных или нулю.
Поскольку блокировки диспетчера буфера не берутся для копирования состояния буфера, которое будет отображать представление, доступ к представлению pg_buffercache оказывает меньшее влияние на обычную активность буфера, но он не предоставляет согласованный набор результатов во всех буферах. Однако гарантируется, что информация каждого буфера является самосогласованной.
Функция pg_buffercache_summary()
Определения столбцов, раскрываемых функцией, приведены в таблице ниже.
Столбцы вывода 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()
Определения столбцов, раскрываемых функцией, приведены в таблице ниже.
Столбцы вывода 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() не захватывает блокировки менеджера буферов. Поэтому параллельная активность может привести к незначительным неточностям в результате.
Функция 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)