Materialize

说明

保存子计划输出，使这些行可以再次读取。

核心节点标签

T_Material

结构化 EXPLAIN 节点类型

Materialize

输入

一个子计划

输出

已物化的元组

执行器初始化函数

ExecInitMaterial

内存机制

tuplestore

EXPLAIN 名称与属性

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

此源码记录的文本名称：Materialize.

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

内存与临时存储

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

并行执行与运行信息采集

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

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

同版本手册说明

规划器在连接内侧关系之上加入 Materialize 节点，将其物化。因此，尽管嵌套循环连接需要为外侧的每一行读取一次内侧数据、共十次，t2 的索引扫描也只执行一次。Materialize 在读取时将数据保存在内存中，后续各轮直接从内存返回数据。

本版手册中的示例

示例摘自 PostgreSQL 18.6 手册；本百科未实际执行此示例。

本例中，连接的输出行数等于两次扫描行数的乘积，但并非总是如此：可能存在同时引用两个表的额外 WHERE 子句，只能在连接时应用，无法应用到任何单侧输入扫描。示例如下：

EXPLAIN SELECT *
FROM tenk1 t1, tenk2 t2
WHERE t1.unique1 < 10 AND t2.unique2 < 10 AND t1.hundred < t2.hundred;

                                         QUERY PLAN
---------------------------------------------------------------------------------------------
 Nested Loop  (cost=4.65..49.36 rows=33 width=488)
   Join Filter: (t1.hundred < t2.hundred)
   ->  Bitmap Heap Scan on tenk1 t1  (cost=4.36..39.38 rows=10 width=244)
         Recheck Cond: (unique1 < 10)
         ->  Bitmap Index Scan on tenk1_unique1  (cost=0.00..4.36 rows=10 width=0)
               Index Cond: (unique1 < 10)
   ->  Materialize  (cost=0.29..8.51 rows=10 width=244)
         ->  Index Scan using tenk2_unique2 on tenk2 t2  (cost=0.29..8.46 rows=10 width=244)
               Index Cond: (unique2 < 10)

执行器实现说明

只要当前位于 tuplestore 已收集数据的末尾，每次调用就从子计划获取一行新数据，在返回之前将其存入 tuplestore。只有请求反向扫描、重扫或标记／恢复时，才从 tuplestore 读取。

首次执行且需要元组存储时，初始化它。

分配第二个读取指针作为标记。已知其索引必为 1，因此无需另行保存。

如果尚未到达 tuplestore 末尾，或正在反向扫描，则尝试从 tuplestore 获取元组。

在元组存储末尾反转扫描方向时，第一次 gettupleslot 会取得最后添加的元组；但若可能，我们希望返回它之前的那个，因此额外读取一次。

核心源码中的 EXPLAIN 标识

case T_Material:
			pname = sname = "Materialize";
			break;

相关条目

• EXPLAIN
• 使用 EXPLAIN
• 并行计划
• enable_material
• work_mem

文档与源码

• src/backend/commands/explain.c:1516
• src/backend/executor/execProcnode.c:315
• src/backend/executor/nodeMaterial.c
• src/include/nodes/plannodes.h
• src/backend/utils/sort/tuplestore.c
• PostgreSQL 18.6 · using-explain

版本比较

PostgreSQL 17 → 18: 无变化。

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

相关条目

• MemoizeMemoize