F.25. pg_buffercache — информация о состоянии буферного кеша PostgreSQL #
- F.25.1. Представление
pg_buffercache- F.25.2. Представление
pg_buffercache_numa- F.25.3. Функция
pg_buffercache_summary()- F.25.4. Функция
pg_buffercache_usage_counts()- F.25.5. Функция
pg_buffercache_evict()- F.25.6. Функция
pg_buffercache_evict_relation()- F.25.7. Функция
pg_buffercache_evict_all()- F.25.8. Пример вывода
- F.25.9. Авторы
- F.25.2. Представление
Модуль pg_buffercache даёт возможность понять, что происходит в общем кеше буферов в реальном времени, а также позволяет вытеснять данные из него на низком уровне в целях тестирования.
Этот модуль предоставляет функцию pg_buffercache_pages() (обёрнута в представление pg_buffercache), функцию pg_buffercache_numa_pages() (обёрнута в представление pg_buffercache_numa), а также функции pg_buffercache_summary(), pg_buffercache_usage_counts(), pg_buffercache_evict(), pg_buffercache_evict_relation() и pg_buffercache_evict_all().
Функция pg_buffercache_pages() возвращает набор записей, каждая строка которого описывает состояние одного буфера в общем кеше. Для удобства пользования обёрткой функции является представление pg_buffercache.
Функция pg_buffercache_numa_pages() возвращает сопоставления узлов NUMA для буферов в общем кеше. Эта информация не выводится функцией pg_buffercache_pages() без обёртки, поскольку её медленнее извлекать. Для удобства пользования обёрткой функции является представление pg_buffercache_numa.
Функция pg_buffercache_summary() возвращает одну строку со сводной информацией о состоянии общего кеша буферов.
Функция pg_buffercache_usage_counts() возвращает набор записей, в каждой строке которого указано количество буферов в разбивке по счётчику использования.
По умолчанию использование упомянутых выше функций разрешено только суперпользователям и ролям с правами роли pg_monitor. Дать доступ другим ролям можно с помощью GRANT.
Функция pg_buffercache_evict() позволяет вытеснять блоки из пула буферов по идентификатору блока. Вызывать эту функцию разрешено только суперпользователям.
Функция pg_buffercache_evict_relation() позволяет вытеснять из пула буферов все незакреплённые общие буферы в отношении по идентификатору отношения. Вызывать эту функцию разрешено только суперпользователям.
Функция pg_buffercache_evict_all() позволяет вытеснять все незакреплённые общие буферы из пула буферов. Вызывать эту функцию разрешено только суперпользователям.
F.25.1. Представление pg_buffercache #
Определения столбцов, содержащихся в представлении, показаны в Таблице F.14.
Таблица F.14. Столбцы pg_buffercache
Тип столбца Описание |
|---|
ID, в диапазоне 1.. |
Номер файлового узла для отношения |
OID табличного пространства, содержащего отношение |
OID базы данных, содержащей отношение |
Номер слоя в отношении; см. |
Номер страницы в отношении |
Страница загрязнена? |
Счётчик обращений по часовой стрелке |
Число обслуживающих процессов, закрепивших этот буфер |
Для каждого буфера в общем кеше выдаётся одна строка. Для неиспользуемых буферов все поля равны NULL, за исключением bufferid. Общие системные каталоги показываются как относящиеся к базе данных под номером 0.
Так как кеш используется совместно всеми базами данных, обычно в нём находятся и страницы из отношений, не принадлежащих текущей базе данных. Это означает, что для некоторых строк при соединении с pg_class не найдутся соответствующие строки, либо соединение будет некорректным. Если вы хотите выполнить соединение с pg_class, будет правильным ограничить соединение строками, в которых reldatabase содержит OID текущей базы данных или ноль.
Для копирования данных состояния, которые будут отображаться, блокировки в менеджере буферов не устанавливаются. Поэтому обращения к представлению pg_buffercache меньше сказываются на обычной активности буферов, но набор результатов, полученный для всех буферов, в целом может оказаться несогласованным. Однако внутри каждого отдельного буфера согласованность информации гарантируется.
F.25.2. Представление pg_buffercache_numa #
Определения столбцов, содержащихся в представлении, показаны в Таблице F.15.
Таблица F.15. Столбцы pg_buffercache_numa
Тип столбца Описание |
|---|
ID, в диапазоне 1.. |
Номер страницы памяти ОС для этого буфера |
Идентификатор узла NUMA |
Поскольку, чтобы запросить идентификатор узла NUMA для каждой страницы, требуется выгрузить страницы памяти, первое выполнение этой функции может занять много времени. В любом случае (при первом или повторном запуске функции) извлекать информацию таким способом затратно, и часто обращаться к представлению не рекомендуется.
Предупреждение
При определении узла NUMA представление обращается ко всем страницам сегмента разделяемой памяти. Это приводит к принудительному выделению разделяемой памяти, если она не была выделена ранее, при этом память может быть выделена на одном узле NUMA (в зависимости от конфигурации системы).
F.25.3. Функция pg_buffercache_summary() #
Определения столбцов, возвращаемых функцией, показаны в Таблице F.16.
Таблица F.16. Выходные столбцы pg_buffercache_summary()
Тип столбца Описание |
|---|
Число используемых общих буферов |
Число неиспользуемых общих буферов |
Число загрязнённых общих буферов |
Число закреплённых общих буферов |
Среднее значение счётчика использования общих буферов |
Функция pg_buffercache_summary() возвращает одну строку со сводной информацией о состоянии всех общих буферов. Подобную и более подробную информацию можно получить из представления pg_buffercache, но pg_buffercache_summary() обходится существенно дешевле.
Как и представление pg_buffercache, pg_buffercache_summary() не получает блокировки менеджера буферов, поэтому при параллельной работе в базе данных допустима незначительная погрешность результатов функции.
F.25.4. Функция 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.25.5. Функция pg_buffercache_evict() #
Функция pg_buffercache_evict() принимает идентификатор буфера, который отображается в столбце bufferid представления pg_buffercache. Возвращает информацию о том, был ли буфер вытеснен и сброшен. В столбце buffer_evicted выводится true, если буфер был вытеснен, и false, если буфер был недействителен, не мог быть вытеснен, так как был закреплён, или снова загрязнился после попытки записи. В столбце buffer_flushed выводится true, если буфер был сброшен. При этом буфер может быть сброшен любым пользователем. После завершения функции результат сразу становится устаревшим, поскольку из-за параллельно выполняемых операций буфер может снова стать действительным в любое время. Эта функция предназначена только для тестирования.
F.25.6. Функция pg_buffercache_evict_relation() #
Функция pg_buffercache_evict_relation() очень похожа на функцию pg_buffercache_evict(). Отличие состоит в том, что вместо идентификатора буфера функция pg_buffercache_evict_relation() принимает идентификатор отношения. Функция пытается вытеснить все буферы для всех слоёв этого отношения. Возвращает количество вытесненных буферов, сброшенных буферов и буферов, которые вытеснить не удалось. Буферы могли быть сброшены любым пользователем. После завершения функции результат сразу становится устаревшим, поскольку из-за параллельно выполняемых операций буфер может быть снова прочитан. Эта функция предназначена только для тестирования.
F.25.7. Функция pg_buffercache_evict_all() #
Функция pg_buffercache_evict_all() очень похожа на функцию pg_buffercache_evict(). Отличие состоит в том, что функция pg_buffercache_evict_all() не принимает аргументов. Вместо этого она пытается вытеснить все буферы из пула буферов. Возвращает количество вытесненных буферов, сброшенных буферов и буферов, которые вытеснить не удалось. Буферы могли быть сброшены любыми пользователями. После завершения функции результат сразу становится устаревшим, поскольку из-за параллельно выполняемых операций буферы могут быть снова прочитаны. Эта функция предназначена только для тестирования.
F.25.8. Пример вывода #
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.25.9. Авторы #
Марк Кирквуд <markir@paradise.net.nz>
Предложения по конструкции: Нейл Конвей <neilc@samurai.com>
Советы по отладке: Том Лейн <tgl@sss.pgh.pa.us>