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

Table Function Scan

TableFuncScan

扫描 XMLTABLE 等表函数产生的行。

当前查看 PostgreSQL 18.6。

说明

扫描 XMLTABLE 等表函数产生的行。

核心节点标签: T_TableFuncScan
结构化 EXPLAIN 节点类型: Table Function Scan
输入: 表函数表达式
输出: 表函数结果元组
执行器初始化函数: ExecInitTableFuncScan
内存机制: tuplestore

EXPLAIN 名称与属性

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

此源码记录的文本名称：Table Function Scan.

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

内存与临时存储

此节点使用 work_mem 创建 tuplestore。tuplestore 可以将存储的元组移到临时文件，但这不意味着 work_mem 限制了节点的全部内存分配。

并行执行与运行信息采集

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

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

执行器实现说明

nodeTableFuncscan.c：支持扫描 RangeTableFunc（类似 XMLTABLE 的函数）的例程。

首次执行时，从函数读取全部元组并存入 tuplestore；后续调用只需从 tuplestore 获取元组。

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

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

每次调用获取一组新行都可能分配大量内存；当 XMLTABLE 或 JSON_TABLE 用于横向连接时，此类调用可能很多，因此这里不能使用查询级内存上下文。perTableCxt 现在承担与 FunctionScan 中“argcontext”相同的作用，用于存储生命周期限定为一次调用（即一个结果表）的数据，而非整个查询或单个结果元组的数据。

核心源码中的 EXPLAIN 标识

case T_TableFuncScan:
			pname = sname = "Table Function Scan";
			break;

本构建中的 EXPLAIN 标签

文本格式标签	结构化节点标识
Table Function Scan	Table Function Scan

文档与源码

来源构建

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

版本比较

PostgreSQL 17 → 18: 无变化。

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

快速链接