CTE Scan
CteScan
读取公共表表达式计划的共享元组存储，并在需要时请求该计划生成更多行。
当前查看 PostgreSQL 18。
中文定义与说明
读取公共表表达式计划的共享元组存储，并在需要时请求该计划生成更多行。
核心节点标识：T_CteScan；EXPLAIN 名称：CTE Scan。
本版本源码中的并行执行或观测回调：该节点实现中未提取到此类回调。回调的存在不表示该节点必然支持共享并行扫描；在并行工作进程中执行也不等于具有并行感知能力。
该节点使用受 work_mem 影响的元组存储，必要时可将存储的元组写入临时文件。这并不表示 work_mem 限制了该节点的所有内存分配。
同版本中文手册节选
PostgreSQL 会为收到的每个查询制定一个查询计划。选择与查询结构和数据特性相匹配的正确计划，对获得良好的性能至关重要，因此系统内置了一个复杂的规划器来尽量选出好的计划。可以使用 EXPLAIN 命令查看规划器为任意查询生成的查询计划。读懂计划是一门需要经验积累的技能，本节将尝试介绍其中的基础知识。
本节中的示例取自执行过 VACUUM ANALYZE 的回归测试数据库，使用的是 v18 开发版本源码。如果自行尝试这些示例，通常应当能得到相近的结果，但估计代价和行计数可能略有差异，因为 ANALYZE 生成的统计信息来自随机采样而非精确计数，而且代价本身在某种程度上也依赖于平台。
这些示例使用 EXPLAIN 默认的“text”输出格式，它紧凑且便于人工阅读。如果希望将 EXPLAIN 的输出交给程序做进一步分析，则应改用机器可读的输出格式（XML、JSON 或 YAML）。
本页开头的中文说明为 PG.CENTER 对编辑说明的翻译；手册节选保留对应版本中文文档原文。源码信息及手册示例不代表重新进行过运行测试。
说明
读取公共表表达式计划的共享元组存储，并在需要时请求该计划生成更多行。
- 核心节点标签
- T_CteScan
- 结构化 EXPLAIN 节点类型
- CTE Scan
- 输入
- CTE 执行计划及共享的 tuplestore
- 输出
- CTE 结果元组
- 执行器初始化函数
- ExecInitCteScan
- 内存机制
- tuplestore
EXPLAIN 名称与属性
结构化格式使用上述 Node Type。文本格式名称还可能包含操作、策略、连接类型、扫描方向或聚合阶段属性。
此源码记录的文本名称：CTE Scan.
并行感知与并行安全是不同的计划属性。在并行工作进程内运行的节点不一定是并行感知节点。
内存与临时存储
此节点使用 work_mem 创建 tuplestore。tuplestore 可以将存储的元组移到临时文件，但这不意味着 work_mem 限制了节点的全部内存分配。
并行执行与运行信息采集
以下源码回调可以协调执行或收集工作进程的测量数据。回调存在不代表该节点普遍支持共享并行扫描或共享状态。
此构建的回调：none extracted from this node implementation.
执行器实现说明
如果尚未到达 tuplestore 末尾，或正在反向扫描，则尝试从 tuplestore 获取元组。
在元组存储末尾反转扫描方向时，第一次 gettupleslot 会取得最后添加的元组；但若可能，我们希望返回它之前的那个，因此额外读取一次。
若能从元组存储再取得一个元组，则返回它。
注意：调用 tuplestore_gettupleslot 时必须使用 copy=true，因为其他节点共享该元组存储，并可能在下次调用之前写入它。
注意：eof_cte 状态变量用于避免继续调用 CTE 计划。遗憾的是它不可省略，因为某些计划节点已经返回 NULL 后若再次被调用，并不能稳健处理。
核心源码中的 EXPLAIN 标识
case T_CteScan:
pname = sname = "CTE Scan";
break;本构建中的 EXPLAIN 标签
| 文本格式标签 | 结构化节点标识 |
|---|---|
| CTE Scan | CTE Scan |
相关条目
文档与源码
- src/backend/commands/explain.c:1474
- src/backend/executor/execProcnode.c:269
- src/backend/executor/nodeCtescan.c
- src/include/nodes/plannodes.h
- src/backend/utils/sort/tuplestore.c
来源构建
- 版本
- 18.6
- 构建
- PostgreSQL 18.6 source archive
- 来源指纹
555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f
版本比较
PostgreSQL 17 → 18: 无变化。
比较已记录的接口与属性，排除来源指纹和构建元数据。某个样本中没有记录，不能据此判断实际引入或移除的版本。
相关条目
Bitmap Heap ScanBitmapHeapScanFunction ScanFunctionScanIndex Only ScanIndexOnlyScanIndex ScanIndexScanNamed Tuplestore ScanNamedTuplestoreScanSample ScanSampleScanSeq ScanSeqScanSubquery ScanSubqueryScanTable Function ScanTableFuncScanTid Range ScanTidRangeScanTid ScanTidScanValues ScanValuesScan
导出 JSON · 返回执行计划节点 · 收录范围为 PostgreSQL 10 至 20；最早采样版本不一定是实际引入版本。