Seq Scan
SeqScan
顺序扫描关系并应用扫描条件。
当前查看 PostgreSQL 18。
中文定义与说明
顺序扫描关系并应用扫描条件。
核心节点标识：T_SeqScan；EXPLAIN 名称：Seq Scan。
本版本源码中的并行执行或观测回调：ExecSeqScanEstimate, ExecSeqScanInitializeDSM, ExecSeqScanInitializeWorker, ExecSeqScanReInitializeDSM。回调的存在不表示该节点必然支持共享并行扫描；在并行工作进程中执行也不等于具有并行感知能力。
同版本中文手册节选
查询计划的结构是一棵由计划节点组成的树。树的最底层是扫描节点，它们从表中返回原始行。不同的表访问方法对应不同类型的扫描节点，例如顺序扫描、索引扫描和位图索引扫描。也有一些并非表的行来源，例如 VALUES 子句和 FROM 中的返回集合函数，它们也各自有对应的扫描节点类型。如果查询需要对原始行执行连接、聚合、排序或其他操作，那么扫描节点之上还会出现额外的节点来完成这些操作。同样，这些操作通常不止一种实现方式，因此这里也会出现不同的节点类型。EXPLAIN 会为计划树中的每个节点输出一行，显示基本节点类型以及规划器对该计划节点执行代价的估计值。还可能出现相对节点摘要行缩进的附加行，用来显示该节点的更多属性。第一行，也就是最顶层节点的摘要行，给出了整个计划的估计总执行代价；规划器力图最小化的正是这个数字。
下面是一个简单的示例，仅用于展示输出的样子：
由于这个查询没有 WHERE 子句，它必须扫描表中的所有行，因此规划器选择了一个简单的顺序扫描计划。圆括号中的数字从左到右依次表示：
这些代价使用由规划器代价参数决定的任意单位来衡量（见第 19.7.2 节）。传统上通常以磁盘页读取作为代价单位；也就是说，惯例上将 seq_page_cost 设为 1.0，其他代价参数都相对它来设定。本节中的示例都使用默认代价参数。
本页开头的中文说明为 PG.CENTER 对编辑说明的翻译；手册节选保留对应版本中文文档原文。源码信息及手册示例不代表重新进行过运行测试。
说明
顺序扫描关系并应用扫描条件。
- 核心节点标签
- 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 |
相关条目
文档与源码
- src/backend/commands/explain.c:1432
- src/backend/executor/execProcnode.c:209
- src/backend/executor/nodeSeqscan.c
- src/include/nodes/plannodes.h
- PostgreSQL 18.6 · using-explain
来源构建
- 版本
- 18.6
- 构建
- PostgreSQL 18.6 source archive
- 来源指纹
555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f
版本比较
PostgreSQL 17 → 18: 无变化。
比较已记录的接口与属性，排除来源指纹和构建元数据。某个样本中没有记录，不能据此判断实际引入或移除的版本。
相关条目
Bitmap Heap ScanBitmapHeapScanCTE ScanCteScanFunction ScanFunctionScanIndex Only ScanIndexOnlyScanIndex ScanIndexScanNamed Tuplestore ScanNamedTuplestoreScanSample ScanSampleScanSubquery ScanSubqueryScanTable Function ScanTableFuncScanTid Range ScanTidRangeScanTid ScanTidScanValues ScanValuesScan
导出 JSON · 返回执行计划节点 · 收录范围为 PostgreSQL 10 至 20；最早采样版本不一定是实际引入版本。