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

Index Only Scan

IndexOnlyScan

使用索引值生成结果并检查元组可见性；可见性映射不足以判定时访问堆。

当前查看 PostgreSQL 18.6。

说明

使用索引值生成结果并检查元组可见性；可见性映射不足以判定时访问堆。

核心节点标签: T_IndexOnlyScan
结构化 EXPLAIN 节点类型: Index Only Scan
输入: 索引、关系及可见性信息
输出: 来自索引值且满足条件的元组
执行器初始化函数: ExecInitIndexOnlyScan
内存机制: unclassified

EXPLAIN 名称与属性

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

此源码记录的文本名称：Index Only Scan.

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

内存与临时存储

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

并行执行与运行信息采集

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

此构建的回调：ExecIndexOnlyScanEstimate, ExecIndexOnlyScanInitializeDSM, ExecIndexOnlyScanInitializeWorker, ExecIndexOnlyScanReInitializeDSM, ExecIndexOnlyScanRetrieveInstrumentation.

本版手册中的示例

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

在上面的例子中， ALL 操作符会对外层查询的每一行都重新执行一次子计划（这也是估计代价很高的原因）。有些查询可以使用 hash 子计划来避免这一点：

EXPLAIN SELECT *
FROM tenk1 t
WHERE t.unique1 NOT IN (SELECT o.unique1 FROM onek o);

                                         QUERY PLAN
--------------------------------------------------------------------------------------------
 Seq Scan on tenk1 t  (cost=61.77..531.77 rows=5000 width=244)
   Filter: (NOT (ANY (unique1 = (hashed SubPlan 1).col1)))
   SubPlan 1
     ->  Index Only Scan using onek_unique1 on onek o  (cost=0.28..59.27 rows=1000 width=4)
(4 rows)

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

“ Index Searches ” 这一行对于应用了跳过扫描（skip scan）优化、以更高效方式遍历索引的 B-树索引扫描同样有用：

EXPLAIN ANALYZE SELECT four, unique1 FROM tenk1 WHERE four BETWEEN 1 AND 3 AND unique1 = 42;
                                                              QUERY PLAN
----------------------------------------------------------------------------------------------------------------------------------
 Index Only Scan using tenk1_four_unique1_idx on tenk1  (cost=0.29..6.90 rows=1 width=8) (actual time=0.006..0.007 rows=1.00 loops=1)
   Index Cond: ((four >= 1) AND (four <= 3) AND (unique1 = 42))
   Heap Fetches: 0
   Index Searches: 3
   Buffers: shared hit=7
 Planning Time: 0.029 ms
 Execution Time: 0.012 ms

执行器实现说明

根据计划的扫描方向和当前执行方向，确定索引扫描方向。

仅索引扫描不并行执行，或原计划并行的仅索引扫描以串行方式执行时，会到达此处。

如果没有需要计算的运行时键，或运行时键已准备就绪，则将扫描键传给索引访问方法。

若 TID 指向的堆页面上所有元组都已知对所有事务可见，就可以跳过堆读取。无论是否读取堆，都使用索引元组而非堆元组作为数据来源。

关于内存序：visibilitymap_get_status 不锁定可见性映射缓冲区，因此此处读到的结果可能稍有滞后，但不会滞后到影响正确性。

核心源码中的 EXPLAIN 标识

case T_IndexOnlyScan:
			pname = sname = "Index Only Scan";
			break;

本构建中的 EXPLAIN 标签

文本格式标签	结构化节点标识
Index Only Scan	Index Only Scan

文档与源码

来源构建

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

版本比较

PostgreSQL 18 → 19: 属性变化。

以下差异保留原始字段名与英文源描述。

--- PostgreSQL 18
+++ PostgreSQL 19
@@ -6,6 +6,7 @@
     "ExecIndexOnlyScanEstimate",
     "ExecIndexOnlyScanInitializeDSM",
     "ExecIndexOnlyScanInitializeWorker",
+    "ExecIndexOnlyScanInstrumentEstimate",
     "ExecIndexOnlyScanReInitializeDSM",
     "ExecIndexOnlyScanRetrieveInstrumentation"
   ],

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

快速链接