Custom Scan

说明

执行自定义扫描提供方给出的计划。

核心节点标签

T_CustomScan

结构化 EXPLAIN 节点类型

Custom Scan

输入

提供方定义的计划，可能包含子计划

输出

提供方定义的元组

执行器初始化函数

ExecInitCustomScan

内存机制

unclassified

EXPLAIN 名称与属性

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

此源码记录的文本名称：Custom Scan (%s).

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

内存与临时存储

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

并行执行与运行信息采集

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

此构建的回调：ExecCustomScanEstimate, ExecCustomScanInitializeDSM, ExecCustomScanInitializeWorker, ExecCustomScanReInitializeDSM.

执行器实现说明

nodeCustom.c：处理自定义扫描节点执行的例程。

分配 CustomScanState 对象。由自定义扫描提供者调用 palloc，以便它可以分配一个更大的对象，并将 CustomScanState 嵌入为首字段。此时必须正确设置节点标签和 methods 字段；其他标准字段应置零。

若 CustomScanState 指定了自定义槽位则使用它，否则使用虚拟槽位。

确定扫描元组的类型。如果自定义扫描提供者给出了描述扫描元组的目标列表，则使用该列表；否则使用基表关系的行类型。

自定义扫描提供者的回调按自身逻辑完成自定义扫描状态节点的最后初始化。

核心源码中的 EXPLAIN 标识

case T_CustomScan:
			sname = "Custom Scan";
			custom_name = ((CustomScan *) plan)->methods->CustomName;
			if (custom_name)
				pname = psprintf("Custom Scan (%s)", custom_name);
			else
				pname = sname;
			break;

相关条目

• EXPLAIN
• 使用 EXPLAIN
• 并行计划

文档与源码

• src/backend/commands/explain.c:1508
• src/backend/executor/execProcnode.c:289
• src/backend/executor/nodeCustom.c
• src/include/nodes/plannodes.h

版本比较

PostgreSQL 17 → 18: 无变化。

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

相关条目

• Foreign ScanForeignScan