↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / 执行计划节点 / 扫描

Sample Scan

SampleScan

使用选定的表采样方法读取关系。

当前查看 PostgreSQL 18.6。

说明

使用选定的表采样方法读取关系。

核心节点标签
T_SampleScan
结构化 EXPLAIN 节点类型
Sample Scan
输入
关系及采样方法
输出
采样元组
执行器初始化函数
ExecInitSampleScan
内存机制
unclassified

EXPLAIN 名称与属性

结构化格式使用上述 Node Type。文本格式名称还可能包含操作、策略、连接类型、扫描方向或聚合阶段属性。

此源码记录的文本名称:Sample Scan.

并行感知与并行安全是不同的计划属性。在并行工作进程内运行的节点不一定是并行感知节点。

内存与临时存储

本次抽取不为此节点设定统一的内存上限或落盘策略。请查看同一构建的实现、相关表达式或提供方。

并行执行与运行信息采集

以下源码回调可以协调执行或收集工作进程的测量数据。回调存在不代表该节点普遍支持共享并行扫描或共享状态。

此构建的回调:none extracted from this node implementation.

执行器实现说明

nodeSamplescan.c:支持关系采样扫描(表采样)的例程。

SampleRecheck:在 EvalPlanQual 中重新检查元组的访问方法例程。

SampleScan 无需重新检查,因为它和 SeqScan 一样,不向 heap_beginscan 传递可检查的键。

使用采样方法扫描关系,并返回下一个满足条件的元组。调用 ExecScan() 并传入相应的访问方法函数。

如果没有 REPEATABLE 子句,则选择一个随机种子。只应选择一次,因为重扫时种子不应改变。

核心源码中的 EXPLAIN 标识

case T_SampleScan:
			pname = sname = "Sample Scan";
			break;

本构建中的 EXPLAIN 标签

文本格式标签结构化节点标识
Sample ScanSample Scan

相关条目

文档与源码

来源构建
版本
18.6
构建
PostgreSQL 18.6 source archive
来源指纹
555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f

版本比较

PostgreSQL 17 → 18: 无变化。

比较已记录的接口与属性,排除来源指纹和构建元数据。某个样本中没有记录,不能据此判断实际引入或移除的版本。

相关条目

导出 JSON · 返回执行计划节点 · 收录范围为 PostgreSQL 10 至 20;最早采样版本不一定是实际引入版本。