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

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

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

WorkTable Scan

WorkTableScan

读取递归 UNION 当前的工作表。

当前查看 PostgreSQL 18。

中文定义与说明

读取递归 UNION 当前的工作表。

核心节点标识:T_WorkTableScan;EXPLAIN 名称:WorkTable Scan。

本版本源码中的并行执行或观测回调:该节点实现中未提取到此类回调。回调的存在不表示该节点必然支持共享并行扫描;在并行工作进程中执行也不等于具有并行感知能力。

同版本中文手册节选

PostgreSQL 会为收到的每个查询制定一个查询计划。选择与查询结构和数据特性相匹配的正确计划,对获得良好的性能至关重要,因此系统内置了一个复杂的规划器来尽量选出好的计划。可以使用 EXPLAIN 命令查看规划器为任意查询生成的查询计划。读懂计划是一门需要经验积累的技能,本节将尝试介绍其中的基础知识。

本节中的示例取自执行过 VACUUM ANALYZE 的回归测试数据库,使用的是 v18 开发版本源码。如果自行尝试这些示例,通常应当能得到相近的结果,但估计代价和行计数可能略有差异,因为 ANALYZE 生成的统计信息来自随机采样而非精确计数,而且代价本身在某种程度上也依赖于平台。

这些示例使用 EXPLAIN 默认的“text”输出格式,它紧凑且便于人工阅读。如果希望将 EXPLAIN 的输出交给程序做进一步分析,则应改用机器可读的输出格式(XML、JSON 或 YAML)。

查看完整中文手册与上下文。

本页开头的中文说明为 PG.CENTER 对编辑说明的翻译;手册节选保留对应版本中文文档原文。源码信息及手册示例不代表重新进行过运行测试。

说明

读取递归 UNION 当前的工作表。

核心节点标签
T_WorkTableScan
结构化 EXPLAIN 节点类型
WorkTable Scan
输入
递归查询工作表
输出
工作表元组
执行器初始化函数
ExecInitWorkTableScan
内存机制
unclassified

EXPLAIN 名称与属性

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

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

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

内存与临时存储

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

并行执行与运行信息采集

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

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

执行器实现说明

注意:这里有意不支持反向扫描。虽然增加几行代码即可实现,但这会迫使 nodeRecursiveunion.c 创建启用反向扫描的元组存储,带来性能开销。实际上,工作表节点不会在可滚动游标计划树中处于足够高的位置,不会遇到反向扫描要求,因此为其提供支持不值得。

注意:这里还假定此节点是工作表的唯一读取者。因此无需为元组存储设置私有读取指针,也不必要求 tuplestore_gettupleslot 复制元组。

从元组存储取得下一个元组;没有更多元组时返回 NULL。

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

顺序扫描工作表并返回下一个满足条件的元组。调用 ExecScan() 并传入相应的访问方法函数。

核心源码中的 EXPLAIN 标识

case T_WorkTableScan:
			pname = sname = "WorkTable Scan";
			break;

本构建中的 EXPLAIN 标签

文本格式标签结构化节点标识
WorkTable ScanWorkTable Scan

相关条目

文档与源码

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

版本比较

PostgreSQL 17 → 18: 无变化。

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

相关条目

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