Расширение pgpro_result_cache кеширует результаты запросов в разделяемой памяти с помощью указаний, повышая производительность при повторном выполнении запросов. Кешированные результаты не сохраняются после перезапуска сервера.

Расширение pgpro_result_cache поставляется вместе с Postgres Pro Enterprise в виде отдельного пакета pgpro-result-cache-ent-17 (подробные инструкции по установке приведены в Главе 17).

Чтобы включить pgpro_result_cache, выполните следующие действия:

Задавайте любые поддерживаемые указания в комментарии особого вида, который начинается с символов /*+ и заканчивается символами */. Учтите, что pgpro_result_cache читает только первый блок комментариев. Если задано несколько указаний, применяется только последнее.

-- Кеширует текущее время
SELECT /*+result_cache*/ now();

-- Возвращает ранее сохранённое время из кеша
SELECT /*+result_cache*/ now();

CREATE TABLE t as SELECT generate_series(1,20) x;

-- Кеширует значения от 1 до 20, возвращает значения от 1 до 10
SELECT /*+result_cache(limit 10)*/ x FROM t;

-- Возвращает значения от 6 до 20
SELECT /*+result_cache(offset 5)*/ x FROM t;

-- Оба запроса возвращают значения от 6 до 15
SELECT /*+result_cache(offset 5 limit 10)*/ x FROM t;
SELECT /*+result_cache(limit 10 offset 5)*/ x FROM t;

-- Кеширует значения от 6 до 20, возвращает значения от 11 до 20
SELECT /*+result_cache(offset 5 limit 10)*/ x FROM t OFFSET 5;

-- Кеширует значения от 1 до 10, возвращает значения от 6 до 10
SELECT /*+result_cache(offset 5 limit 10)*/ x FROM t LIMIT 10;

SET pgpro_result_cache.enforced = on;

-- Кеширует текущее время
SELECT now();

-- Возвращает ранее сохранённое время из кеша
SELECT now();

-- Возвращает текущее время
SELECT /*+no_result_cache*/ now();

Все кешированные наборы результатов хранятся в разделяемой памяти. Можно получить информацию об этих наборах результатов с помощью представления pgpro_result_cache_data.

Параметр pgpro_result_cache.max_memory_size задаёт максимальный размер разделяемой памяти кеша. Параметр pgpro_result_cache.max_entries определяет максимальное количество кешированных наборов результатов. Если при добавлении нового значения достигнут какой-то из этих пределов, pgpro_result_cache удаляет наборы результатов из памяти кеша с помощью алгоритма вытеснения давно неиспользуемых данных (least recently used, LRU).

Можно также указать время жизни (Time To Live, TTL) кешированных наборов результатов с помощью параметра pgpro_result_cache.ttl. Набор результатов считается действительным и хранится в памяти кеша пока не истечёт его TTL.

По умолчанию автоматическое аннулирование кеша выключено. Учитывайте следующие особенности работы расширения:

Кешированный набор результатов идентифицируется комбинацией атрибутов database_id, query_id, const_hash, params_hash и query_string. Атрибуты database_id и query_id назначаются сервером Postgres Pro Enterprise.

const_hash содержит вычисленный хеш всех констант, содержащихся в запросе. Константы с одинаковым значением, но разными типами, например, 1 и '1', дадут разные значения хеша. 0 означает отсутствие констант.

params_hash содержит вычисленный хеш всех значений параметров запроса. 0 означает отсутствие параметров.

Расширение pgpro_result_cache поддерживает автоматическое аннулирование для обеспечения согласованности кешированных результатов с помощью отслеживания изменений базы данных и применения определённых ограничений. По умолчанию автоматическое аннулирование выключено. Чтобы включить его, установите для параметра pgpro_result_cache.consistent значение on. Изменение этого параметра сбрасывает кеш.

Когда включено автоматическое аннулирование, расширение работает следующим образом:

Чтобы включить автоматическое аннулирование на уровне кластера, установите для параметров pgpro_result_cache.consistent и pgpro_result_cache.wal значения on на ведущем узле и всех ведомых узлах. В этом случае ведущий узел и каждый ведомый узел хранят свои собственные кешированные наборы результатов. Каждая DML- или DDL-операция на ведущем узле вызывает автоматическое аннулирование кеша для соответствующих отношений на всех ведомых узлах с помощью файлов WAL.

Указания расширения pgpro_result_cache можно использовать вместе с указаниями, поддерживаемыми расширением pg_hint_plan. Каждое расширение читает только его поддерживаемые указания и игнорирует остальные.

/*+result_cache SeqScan(t1)*/
SELECT * FROM table1 t1 JOIN table table2 t2 ON (t1.key = t2.key);

Вызывать нижеуказанные функции может только суперпользователь.