↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / 执行计划节点 / 位图

BitmapAnd

BitmapAnd

对各子计划生成的位图求交集。

当前查看 PostgreSQL 18。

中文定义与说明

对各子计划生成的位图求交集。

核心节点标识:T_BitmapAnd;EXPLAIN 名称:BitmapAnd。

本版本源码中的并行执行或观测回调:该节点实现中未提取到此类回调。回调的存在不表示该节点必然支持共享并行扫描;在并行工作进程中执行也不等于具有并行感知能力。

同版本中文手册节选

EXPLAIN ANALYZE 测得的运行时间,可能以两种重要方式偏离同一查询的正常执行时间。第一,由于不会向客户端传递任何输出行,因此网络传输开销不会被计入。除非指定了 SERIALIZE,I/O 转换开销同样也不会被计入。第二,EXPLAIN ANALYZE 附加的测量开销本身可能相当可观,尤其是在操作系统调用 gettimeofday() 较慢的机器上。可以使用 pg_test_timing 工具来测量系统上的计时开销。

不应将 EXPLAIN 结果外推到与实际测试场景差异很大的情况。例如,在一个很小的表上得到的结果,不能假定也适用于大型表。规划器的代价估计不是线性的,因此它可能会为更大或更小的表选择不同的计划。一个极端示例是:对于只占用一个磁盘页的表,无论索引是否可用,几乎总会得到顺序扫描计划。规划器认识到,无论如何处理该表都需要一次磁盘页读取,因此再额外读取页面去查看索引并没有价值。(前面的 polygon_tbl 示例已经展示过这种情况。)

在某些情况下,实际值和估计值不会很好地对应,但这并不表示出现了问题。其中一种情况是,计划节点的执行会被 LIMIT 或类似效果提前截断。例如,在前面用过的 LIMIT 查询中:

Index Scan 节点的估计代价和行计数显示得像是它会运行到结束一样。但实际上,Limit 节点在拿到两行之后就停止请求更多行,因此实际行计数只有 2,运行时间也低于代价估计所暗示的水平。这并不是估计错误,只是估计值与真实值的显示方式不同而已。

查看完整中文手册与上下文。

本页开头的中文说明为 PG.CENTER 对编辑说明的翻译;手册节选保留对应版本中文文档原文。源码信息及手册示例不代表重新进行过运行测试。

说明

对各子计划生成的位图求交集。

核心节点标签
T_BitmapAnd
结构化 EXPLAIN 节点类型
BitmapAnd
输入
产生位图的子计划
输出
元组位置位图,不是元组流
执行器初始化函数
ExecInitBitmapAnd
内存机制
unclassified

EXPLAIN 名称与属性

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

此源码记录的文本名称:BitmapAnd.

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

内存与临时存储

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

并行执行与运行信息采集

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

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

同版本手册说明

由于实现上的限制,BitmapAnd 和 BitmapOr 节点报告的实际行数始终为零。

本版手册中的示例

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

如果 WHERE 引用的多个列上分别建有索引,规划器可能选择用 AND 或 OR 组合这些索引:

EXPLAIN SELECT * FROM tenk1 WHERE unique1 < 100 AND unique2 > 9000;

                                     QUERY PLAN
-------------------------------------------------------------------------------------
 Bitmap Heap Scan on tenk1  (cost=25.07..60.11 rows=10 width=244)
   Recheck Cond: ((unique1 < 100) AND (unique2 > 9000))
   ->  BitmapAnd  (cost=25.07..25.07 rows=10 width=0)
         ->  Bitmap Index Scan on tenk1_unique1  (cost=0.00..5.04 rows=100 width=0)
               Index Cond: (unique1 < 100)
         ->  Bitmap Index Scan on tenk1_unique2  (cost=0.00..19.78 rows=999 width=0)
               Index Cond: (unique2 > 9000)

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

EXPLAIN 有一个 BUFFERS 选项,可为给定查询在规划和执行期间执行的 I/O 操作提供更详细的信息。显示出来的缓冲区数字,是该节点及其所有子节点所命中的、读取的、弄脏的和写出的非去重缓冲区总数。 ANALYZE 选项会隐式启用 BUFFERS 。如果不希望如此,也可以显式关闭 BUFFERS :

EXPLAIN (ANALYZE, BUFFERS OFF) SELECT * FROM tenk1 WHERE unique1 < 100 AND unique2 > 9000;

                                                           QUERY PLAN
---------------------------------------------------------------------------------------------------------------------------------
 Bitmap Heap Scan on tenk1  (cost=25.07..60.11 rows=10 width=244) (actual time=0.105..0.114 rows=10.00 loops=1)
   Recheck Cond: ((unique1 < 100) AND (unique2 > 9000))
   Heap Blocks: exact=10
   ->  BitmapAnd  (cost=25.07..25.07 rows=10 width=0) (actual time=0.100..0.101 rows=0.00 loops=1)
         ->  Bitmap Index Scan on tenk1_unique1  (cost=0.00..5.04 rows=100 width=0) (actual time=0.027..0.027 rows=100.00 loops=1)
               Index Cond: (unique1 < 100)
               Index Searches: 1
         ->  Bitmap Index Scan on tenk1_unique2  (cost=0.00..19.78 rows=999 width=0) (actual time=0.070..0.070 rows=999.00 loops=1)
               Index Cond: (unique2 > 9000)
               Index Searches: 1
 Planning Time: 0.162 ms
 Execution Time: 0.143 ms

执行器实现说明

说明:BitmapAnd 不使用左右子树,而像 Append 一样维护子计划列表。不过其逻辑比 Append 简单得多,因为无需处理正向或反向执行。

对每个待执行计划调用 ExecInitNode,并将结果保存到 bitmapplanstates 数组。

BitmapAnd 计划没有表达式上下文,因为它们从不调用 ExecQual 或 ExecProject,也不需要元组槽。

如果在任何阶段得到完全为空的位图,就可以直接退出,无需执行剩余子计划,因为再进行 AND 运算也不会改变结果。(注意:indxpath.c 按选择率对子计划排序,应当能提高出现这种情况的概率。)

ExecReScan 不知道当前节点的子计划,因此必须自行通知子计划哪些参数发生了变化。

核心源码中的 EXPLAIN 标识

case T_BitmapAnd:
			pname = sname = "BitmapAnd";
			break;

本构建中的 EXPLAIN 标签

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

相关条目

文档与源码

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

版本比较

PostgreSQL 17 → 18: 无变化。

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

相关条目

导出 JSON · 返回执行计划节点 · 收录范围为 PostgreSQL 10 至 20;最早采样版本不一定是实际引入版本。