Index Only Scan

说明

利用索引值生成结果并检查可见性；可见性映射不足以判断时仍访问堆。

核心节点标签

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
• 使用 EXPLAIN
• 并行计划
• enable_indexonlyscan
• random_page_cost
• 索引访问方法

文档与源码

• src/backend/commands/explain.c:1447
• src/backend/executor/execProcnode.c:224
• src/backend/executor/nodeIndexonlyscan.c
• src/include/nodes/plannodes.h
• PostgreSQL 18.6 · using-explain
• PostgreSQL 18.6 · using-explain

版本比较

PostgreSQL 17 → 18: 属性变化。

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

--- PostgreSQL 17
+++ PostgreSQL 18
@@ -6,7 +6,8 @@
     "ExecIndexOnlyScanEstimate",
     "ExecIndexOnlyScanInitializeDSM",
     "ExecIndexOnlyScanInitializeWorker",
-    "ExecIndexOnlyScanReInitializeDSM"
+    "ExecIndexOnlyScanReInitializeDSM",
+    "ExecIndexOnlyScanRetrieveInstrumentation"
   ],
   "partial_modes": [],
   "strategies": [],

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

相关条目

• Bitmap Heap ScanBitmapHeapScan
• CTE ScanCteScan
• Function ScanFunctionScan
• Index ScanIndexScan
• Named Tuplestore ScanNamedTuplestoreScan
• Sample ScanSampleScan
• Seq ScanSeqScan
• Subquery ScanSubqueryScan
• Table Function ScanTableFuncScan
• Tid Range ScanTidRangeScan
• Tid ScanTidScan
• Values ScanValuesScan