tsm_system_rows

接受行数限制的 TABLESAMPLE 方法

概览

扩展包名版本分类许可证语言
tsm_system_rows1.0FUNCPostgreSQLC
ID扩展名BinLibLoadCreateTrustReloc模式
4910tsm_system_rows-
相关扩展random permuteseq tsm_system_time pg_crash pg_idkit pgx_ulid pg_uuidv7 pg_hashids
下游依赖documentdb

版本

PG18PG17PG16PG15PG14
1.01.01.01.01.0

安装

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

CREATE EXTENSION tsm_system_rows;

用法

tsm_system_rows: 基于行数的 TABLESAMPLE 采样方法

提供 SYSTEM_ROWS 表采样方法,精确返回指定数量的行。

CREATE EXTENSION tsm_system_rows;

TABLESAMPLE 方法

SYSTEM_ROWS(count int) – 最大返回行数。

示例

-- 精确采样 100 行
SELECT * FROM my_table TABLESAMPLE SYSTEM_ROWS(100);

-- 快速预览大表中的 10 行
SELECT * FROM large_table TABLESAMPLE SYSTEM_ROWS(10);

执行块级采样(小样本可能出现聚集效应)。如果表中行数少于请求数量,则返回所有行。不支持 REPEATABLE


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