pg_ttl_index

基于TTL索引的自动数据过期清理

概览

扩展包名版本分类许可证语言
pg_ttl_index3.0.0FEATPostgreSQLC
ID扩展名BinLibLoadCreateTrustReloc模式
2740pg_ttl_index-
相关扩展temporal_tables periods hll rum pg_partman pg_cron pg_task timescaledb

pg 14 breaks

版本

类型仓库版本PG 大版本包名依赖
EXTPIGSTY3.0.01817161514pg_ttl_index-
RPMPIGSTY3.0.01817161514pg_ttl_index_$v-
DEBPIGSTY3.0.01817161514postgresql-$v-ttl-index-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64PIGSTY MISS
el8.aarch64PIGSTY MISS
el9.x86_64PIGSTY MISS
el9.aarch64PIGSTY MISS
el10.x86_64PIGSTY MISS
el10.aarch64PIGSTY MISS
d12.x86_64PIGSTY MISS
d12.aarch64PIGSTY MISS
d13.x86_64
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY MISS
d13.aarch64
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY MISS
u22.x86_64
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY MISS
u22.aarch64
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY MISS
u24.x86_64
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY MISS
u24.aarch64
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY 3.0.0
PIGSTY MISS

构建

您可以使用 pig build 命令构建 pg_ttl_index 扩展的 RPM / DEB 包:

pig build pkg pg_ttl_index         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_ttl_index 扩展包的预置二进制包,首先确保 PGDGPIGSTY 仓库已经添加并启用:

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展:

pig install pg_ttl_index;          # 当前活跃 PG 版本安装
pig ext install -y pg_ttl_index -v 18  # PG 18
pig ext install -y pg_ttl_index -v 17  # PG 17
pig ext install -y pg_ttl_index -v 16  # PG 16
pig ext install -y pg_ttl_index -v 15  # PG 15
dnf install -y pg_ttl_index_18       # PG 18
dnf install -y pg_ttl_index_17       # PG 17
dnf install -y pg_ttl_index_16       # PG 16
dnf install -y pg_ttl_index_15       # PG 15
apt install -y postgresql-18-ttl-index   # PG 18
apt install -y postgresql-17-ttl-index   # PG 17
apt install -y postgresql-16-ttl-index   # PG 16
apt install -y postgresql-15-ttl-index   # PG 15

预加载配置

shared_preload_libraries = 'pg_ttl_index';

创建扩展

CREATE EXTENSION pg_ttl_index;

用法

pg_ttl_index: 基于 TTL 索引的自动数据过期

pg_ttl_index 通过将 TTL(生存时间)与时间戳列关联来实现自动数据过期。后台工作进程会定期删除时间戳超过配置过期间隔的行。

快速开始

-- 启动后台工作进程
SELECT ttl_start_worker();

-- 创建带时间戳列的表
CREATE TABLE user_sessions (
    id SERIAL PRIMARY KEY,
    user_id INTEGER,
    session_data JSONB,
    created_at TIMESTAMPTZ DEFAULT NOW()
);

-- 1 小时(3600 秒)后过期
SELECT ttl_create_index('user_sessions', 'created_at', 3600);

函数

函数描述
ttl_start_worker()启动自动清理的后台工作进程
ttl_worker_status()检查工作进程是否正在运行
ttl_runner()手动触发清理
ttl_create_index(table, column, expire_seconds [, batch_size])配置 TTL 过期策略
ttl_drop_index(table, column)移除 TTL 配置
ttl_summary()列出所有 TTL 索引及统计信息

示例

24 小时过期的会话管理:

SELECT ttl_create_index('sessions', 'created_at', 86400, 5000);

7 天日志保留:

SELECT ttl_create_index('app_logs', 'logged_at', 604800);

自定义过期列的缓存条目(0 表示该列本身存储绝对过期时间):

SELECT ttl_create_index('cache_entries', 'expires_at', 0);

监控

SELECT * FROM ttl_summary();

暂停特定表的清理:

UPDATE ttl_index_table SET active = false WHERE table_name = 'user_sessions';

配置

参数描述默认值
pg_ttl_index.naptime清理间隔(秒)60
pg_ttl_index.enabled全局启用/禁用工作进程on
ALTER SYSTEM SET pg_ttl_index.naptime = 30;
SELECT pg_reload_conf();