历史版本。 PostgreSQL 13 已结束支持。 2025-11-13. 请参阅 当前版本手册.
F.41. tsm_system_rows #
tsm_system_rows 模块提供表采样方法
SYSTEM_ROWS，它可用于 SELECT 命令的 TABLESAMPLE 子句中。
这种表采样方法接受一个整数参数，表示最多读取多少行。除非表中没有足够的行，否则生成的样本将始终恰好包含这么多行；如果表中的行数不足，则会选取整个表中的所有行。
与内置的 SYSTEM 采样方法一样，SYSTEM_ROWS 执行块级采样，因此采样并不是完全随机的，可能会受到聚簇效应的影响，特别是在只请求少量行时。
SYSTEM_ROWS 不支持
REPEATABLE 子句。
该模块被认为是“受信任的”，也就是说，它可以由在当前数据库上具有 CREATE 权限的非超级用户安装。
F.41.1. 示例
下面是一个使用 SYSTEM_ROWS 从表中选取样本的示例。首先安装扩展：
CREATE EXTENSION tsm_system_rows;
然后就可以在 SELECT 命令中使用它，例如：
SELECT * FROM my_table TABLESAMPLE SYSTEM_ROWS(100);
这个命令将从表 my_table 中返回一个包含 100 行的样本（除非该表没有 100 个可见行，在这种情况下将返回其中所有行）。