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

Seq Scan

SeqScan

通过顺序扫描读取关系，并应用扫描条件。

当前查看 PostgreSQL 18.6。

说明

通过顺序扫描读取关系，并应用扫描条件。

核心节点标签: T_SeqScan
结构化 EXPLAIN 节点类型: Seq Scan
输入: 关系
输出: 满足条件的关系元组
执行器初始化函数: ExecInitSeqScan
内存机制: unclassified

EXPLAIN 名称与属性

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

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

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

内存与临时存储

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

并行执行与运行信息采集

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

此构建的回调：ExecSeqScanEstimate, ExecSeqScanInitializeDSM, ExecSeqScanInitializeWorker, ExecSeqScanReInitializeDSM.

同版本手册说明

EXPLAIN 将 WHERE 子句显示为 Seq Scan 节点上的 filter 条件。这表示节点对扫描的每一行检查条件，仅输出通过条件的行。WHERE 降低了预计输出行数，但扫描仍需访问全部 10000 行，所以成本没有降低；相反还略有增加（准确说增加 10000 * cpu_operator_cost），以计入检查 WHERE 条件消耗的额外 CPU 时间。

本版手册中的示例

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

下面是一个简单示例，仅用来展示输出形式：

EXPLAIN SELECT * FROM tenk1;

                         QUERY PLAN
-------------------------------------------------------------
 Seq Scan on tenk1  (cost=0.00..445.00 rows=10000 width=244)

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

现在修改查询，添加 WHERE 条件：

EXPLAIN SELECT * FROM tenk1 WHERE unique1 < 7000;

                         QUERY PLAN
------------------------------------------------------------
 Seq Scan on tenk1  (cost=0.00..470.00 rows=7000 width=244)
   Filter: (unique1 < 7000)

执行器实现说明

nodeSeqscan.c：支持关系顺序扫描的例程。

ExecSeqScanEstimate 估算并行扫描所需的 DSM 空间；ExecSeqScanInitializeDSM 初始化并行扫描的 DSM；ExecSeqScanReInitializeDSM 为新一轮并行扫描重新初始化 DSM；ExecSeqScanInitializeWorker 在并行工作进程中附加到 DSM 信息。

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

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

与 IndexScan 不同，SeqScan 从不在 heap_beginscan 中使用键（这很不好），因此这里不检查键是否满足条件。

核心源码中的 EXPLAIN 标识

case T_SeqScan:
			pname = sname = "Seq Scan";
			break;

本构建中的 EXPLAIN 标签

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

文档与源码

来源构建

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

版本比较

PostgreSQL 18 → 19: 属性变化。

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

--- PostgreSQL 18
+++ PostgreSQL 19
@@ -6,7 +6,9 @@
     "ExecSeqScanEstimate",
     "ExecSeqScanInitializeDSM",
     "ExecSeqScanInitializeWorker",
-    "ExecSeqScanReInitializeDSM"
+    "ExecSeqScanInstrumentEstimate",
+    "ExecSeqScanReInitializeDSM",
+    "ExecSeqScanRetrieveInstrumentation"
   ],
   "partial_modes": [],
   "strategies": [],

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

快速链接