Foreign Scan

说明

将外部扫描或受支持的直接修改委托给外部数据包装器。

核心节点标签

T_ForeignScan

结构化 EXPLAIN 节点类型

Foreign Scan

输入

外部数据包装器计划及回调

输出

提供方定义的扫描元组或 RETURNING 元组

执行器初始化函数

ExecInitForeignScan

内存机制

unclassified

EXPLAIN 名称与属性

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

此源码记录的文本名称：Foreign Scan, Foreign Insert, Foreign Update, Foreign Delete.

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

内存与临时存储

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

并行执行与运行信息采集

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

此构建的回调：ExecForeignScanEstimate, ExecForeignScanInitializeDSM, ExecForeignScanInitializeWorker, ExecForeignScanReInitializeDSM.

执行器实现说明

nodeForeignscan.c：支持外部表扫描的例程。

ExecForeignScan 扫描外部表。ExecInitForeignScan 创建并初始化状态信息。ExecReScanForeignScan 重新扫描外部关系。ExecEndForeignScan 释放所有已分配的资源。

直接修改无法重新计算，因此 EvalPlanQual 处理期间不应到达此处。

向 tableoid 写入有效值；这是唯一实际有用的系统列。

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

核心源码中的 EXPLAIN 标识

case T_ForeignScan:
			sname = "Foreign Scan";
			switch (((ForeignScan *) plan)->operation)
			{
				case CMD_SELECT:
					pname = "Foreign Scan";
					operation = "Select";
					break;
				case CMD_INSERT:
					pname = "Foreign Insert";
					operation = "Insert";
					break;
				case CMD_UPDATE:
					pname = "Foreign Update";
					operation = "Update";
					break;
				case CMD_DELETE:
					pname = "Foreign Delete";
					operation = "Delete";
					break;
				default:
					pname = "???";
					break;
			}
			break;

相关条目

• EXPLAIN
• 使用 EXPLAIN
• 并行计划

文档与源码

• src/backend/commands/explain.c:1483
• src/backend/executor/execProcnode.c:284
• src/backend/executor/nodeForeignscan.c
• src/include/nodes/plannodes.h

版本比较

PostgreSQL 17 → 18: 无变化。

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

相关条目

• Custom ScanCustomScan