选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

F.48. tsm_system_rows — TABLESAMPLESYSTEM_ROWS 采样方法 #

tsm_system_rows模块提供表采样方法 SYSTEM_ROWS,它可用于SELECT 命令的TABLESAMPLE子句中。

这种表采样方法接受一个整数参数,表示最多读取多少行。除非表中没有足够的行,否则生成的样本将始终恰好包含这么多行;如果表中的行数不足,则会选取整个表中的所有行。

与内置的SYSTEM采样方法一样, SYSTEM_ROWS执行块级采样,因此采样并不是完全随机的, 可能会受到聚簇效应的影响,特别是在只请求少量行时。

SYSTEM_ROWS不支持 REPEATABLE子句。

该模块被认为是受信任的,也就是说,它可以由在当前数据库上具有CREATE权限的非超级用户安装。

F.48.1. 示例 #

下面是一个使用SYSTEM_ROWS从表中选取样本的示例。 首先安装扩展:

CREATE EXTENSION tsm_system_rows;

然后就可以在SELECT命令中使用它,例如:

SELECT * FROM my_table TABLESAMPLE SYSTEM_ROWS(100);

这个命令将从表my_table中返回一个包含 100 行的样本(除非该表没有 100 个可见行,在这种情况下将返回其中所有行)。