pg_cooldown

remove buffered pages for specific relations

Overview

PackageVersionCategoryLicenseLanguage
pg_cooldown0.1ADMINApache-2.0C
IDExtensionBinLibLoadCreateTrustRelocSchema
5070pg_cooldownNoYesNoYesNoYes-
Relatedpgfincore pgcozy pg_prewarm pg_buffercache pg_repack pg_squeeze system_stats pgmeminfo

Version

TypeRepoVersionPG VerPackageDeps
EXTPIGSTY0.11817161514pg_cooldown-
RPMPIGSTY0.11817161514pg_cooldown_$v-
DEBPIGSTY0.11817161514postgresql-$v-pg-cooldown-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
d12.aarch64
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
d13.x86_64
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
d13.aarch64
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
u22.x86_64
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
u22.aarch64
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
u24.x86_64
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
u24.aarch64
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1
PIGSTY 0.1

Build

You can build the RPM / DEB packages for pg_cooldown using pig build:

pig build pkg pg_cooldown         # build RPM / DEB packages

Install

You can install pg_cooldown directly. First, make sure the PGDG and PIGSTY repositories are added and enabled:

pig repo add pgsql -u          # Add repo and update cache

Install the extension using pig or apt/yum/dnf:

pig install pg_cooldown;          # Install for current active PG version
pig ext install -y pg_cooldown -v 18  # PG 18
pig ext install -y pg_cooldown -v 17  # PG 17
pig ext install -y pg_cooldown -v 16  # PG 16
pig ext install -y pg_cooldown -v 15  # PG 15
pig ext install -y pg_cooldown -v 14  # PG 14
dnf install -y pg_cooldown_18       # PG 18
dnf install -y pg_cooldown_17       # PG 17
dnf install -y pg_cooldown_16       # PG 16
dnf install -y pg_cooldown_15       # PG 15
dnf install -y pg_cooldown_14       # PG 14
apt install -y postgresql-18-pg-cooldown   # PG 18
apt install -y postgresql-17-pg-cooldown   # PG 17
apt install -y postgresql-16-pg-cooldown   # PG 16
apt install -y postgresql-15-pg-cooldown   # PG 15
apt install -y postgresql-14-pg-cooldown   # PG 14

Create Extension:

CREATE EXTENSION pg_cooldown;

Usage

pg_cooldown: remove buffered pages for specific relations

pg_cooldown is the complement to pg_prewarm: it removes all buffered pages of a specific relation from the shared buffer, useful for simulating cold-start scenarios in research and testing.

Remove Pages from Shared Buffer

-- Remove all data pages of a table
SELECT pg_cooldown('my_relation');

-- Remove pages of a primary key index
SELECT pg_cooldown('my_relation_pkey');

-- Remove pages of any index
SELECT pg_cooldown('my_index_name');

Last Modified 2026-03-12: add pg extension catalog (95749bf)