tsm_system_time

接受毫秒数限制的 TABLESAMPLE 方法

概览

扩展包名版本分类许可证语言
tsm_system_time1.0FUNCPostgreSQLC
ID扩展名BinLibLoadCreateTrustReloc模式
4890tsm_system_time-
相关扩展random permuteseq tsm_system_rows pg_crash pg_idkit pgx_ulid pg_uuidv7 pg_hashids

版本

PG18PG17PG16PG15PG14
1.01.01.01.01.0

安装

提示:这是 PostgreSQL 内核自带的 contrib 扩展

CREATE EXTENSION tsm_system_time;

用法

tsm_system_time: 基于时间的 TABLESAMPLE 采样方法

提供 SYSTEM_TIME 表采样方法,在指定时间限制内返回尽可能多的行。

CREATE EXTENSION tsm_system_time;

TABLESAMPLE 方法

SYSTEM_TIME(milliseconds float) – 读取表的最大时间(毫秒)。

示例

-- 采样 1 秒内可读取的行
SELECT * FROM my_table TABLESAMPLE SYSTEM_TIME(1000);

-- 使用 500 毫秒预算从大表中采样
SELECT count(*) FROM large_table TABLESAMPLE SYSTEM_TIME(500);

执行块级采样(非行级)。如果整个表可以在时间限制内读完,则返回所有行。不支持 REPEATABLE


最后修改 2026-03-12: update extension pages (f579993)