Skip to content

Commit faf6a2c

Browse files
authored
update explain analyze from 2091 (#1096)
1 parent 69451b5 commit faf6a2c

4 files changed

Lines changed: 40 additions & 1 deletion

File tree

src/UserGuide/Master/Table/User-Manual/Query-Performance-Analysis.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -151,6 +151,17 @@ A `FragmentInstance` is a wrapper for a query shard in IoTDB. Each query shard o
151151
- Ready Queued Time: Total time the shard's tasks spent in the ready queue (tasks are not blocked but lack query execution thread resources).
152152
- Blocked Queued Time: Total time the shard's tasks spent in the blocked queue (tasks are blocked due to resources like memory or upstream data not being sent).
153153

154+
Since V2.0.9, the following information will be added to `FragmentInstance`:
155+
156+
- `OutputPlanNodeId`: Indicates the downstream node that receives data corresponding to the sink node. Only present in sink nodes.
157+
- `sizeInBytes`: Represents the size in bytes of TsBlocks received in exchange nodes (only data size is counted). Only present in exchange nodes.
158+
- Data filtering‑related fields for `tableScan` nodes. Valid only when filter pushdown is applied to tableScan, and only present in tableScan nodes:
159+
- `TimeSeriesIndexFilteredRows`: Number of rows filtered out by TimeseriesMetadata
160+
- `ChunkIndexFilteredRows`: Number of rows filtered out by ChunkMetadata
161+
- `PageIndexFilteredRows`: Number of rows filtered out by PageHeader internal filtering
162+
- `RowScanFilteredRows`: Number of rows filtered out during per-row data inspection. Only displayed when `verbose` is enabled.
163+
164+
154165
#### BloomFilter-Related Metrics
155166

156167
Bloom filters help determine if a sequence exists in a TsFile. They are stored at the end of each TsFile.

src/UserGuide/latest-Table/User-Manual/Query-Performance-Analysis.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -151,6 +151,17 @@ A `FragmentInstance` is a wrapper for a query shard in IoTDB. Each query shard o
151151
- Ready Queued Time: Total time the shard's tasks spent in the ready queue (tasks are not blocked but lack query execution thread resources).
152152
- Blocked Queued Time: Total time the shard's tasks spent in the blocked queue (tasks are blocked due to resources like memory or upstream data not being sent).
153153

154+
Since V2.0.9, the following information will be added to `FragmentInstance`:
155+
156+
- `OutputPlanNodeId`: Indicates the downstream node that receives data corresponding to the sink node. Only present in sink nodes.
157+
- `sizeInBytes`: Represents the size in bytes of TsBlocks received in exchange nodes (only data size is counted). Only present in exchange nodes.
158+
- Data filtering‑related fields for `tableScan` nodes. Valid only when filter pushdown is applied to tableScan, and only present in tableScan nodes:
159+
- `TimeSeriesIndexFilteredRows`: Number of rows filtered out by TimeseriesMetadata
160+
- `ChunkIndexFilteredRows`: Number of rows filtered out by ChunkMetadata
161+
- `PageIndexFilteredRows`: Number of rows filtered out by PageHeader internal filtering
162+
- `RowScanFilteredRows`: Number of rows filtered out during per-row data inspection. Only displayed when `verbose` is enabled.
163+
164+
154165
#### BloomFilter-Related Metrics
155166

156167
Bloom filters help determine if a sequence exists in a TsFile. They are stored at the end of each TsFile.

src/zh/UserGuide/Master/Table/User-Manual/Query-Performance-Analysis.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -156,7 +156,15 @@ Explain Analyze 是 IOTDB 查询引擎自带的性能分析 SQL,与 Explain
156156
- loadChunkFromCacheCount: 命中ChunkCache的次数,注意这里对于对齐设备来讲,每个分量(包括time列,都会去单独请求Cache,所以对于对齐设备来讲,(loadChunkFromCacheCount + loadChunkFromDiskCount)= tsfile number * subSensor number(包括time列)* avg chunk number in each tsfile
157157
- loadChunkFromDiskCount: 从磁盘中读取Chunk的次数,一次只会读取一个分量,并缓存在ChunkCache中
158158
- loadChunkActualIOSize: 从磁盘中读取Chunk时耗费的磁盘IO(单位为bytes)
159-
159+
160+
自V2.0.9起,在 FragmentInstance 中,将增加如下信息:
161+
- OutputPlanNodeId:表示sink节点对应的下游接收数据的节点,仅在sink节点中出现
162+
- sizeInBytes:表示exchange节点中接收到的TsBlock的字节(仅计算数据占用大小),仅在exchange节点中出现
163+
- tableScan节点过滤数据相关字段,仅在filter下推到tableScan中才有效,且仅在tableScan节点中出现:
164+
- TimeSeriesIndexFilteredRows : 通过序列元数据(TimeseriesMetadata)过滤掉的数据行数
165+
- ChunkIndexFilteredRows: 通过列块元数据(ChunkMetadata)过滤掉的数据行数
166+
- PageIndexFilteredRows:通过页头内部(PageHeader)过滤掉的数据行数
167+
- RowScanFilteredRows:一行行检查数据时候被过滤掉的行数(仅在带有verbose时才会展现)
160168

161169
##### 特别说明
162170

src/zh/UserGuide/latest-Table/User-Manual/Query-Performance-Analysis.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -156,6 +156,15 @@ Explain Analyze 是 IOTDB 查询引擎自带的性能分析 SQL,与 Explain
156156
- loadChunkFromCacheCount: 命中ChunkCache的次数,注意这里对于对齐设备来讲,每个分量(包括time列,都会去单独请求Cache,所以对于对齐设备来讲,(loadChunkFromCacheCount + loadChunkFromDiskCount)= tsfile number * subSensor number(包括time列)* avg chunk number in each tsfile
157157
- loadChunkFromDiskCount: 从磁盘中读取Chunk的次数,一次只会读取一个分量,并缓存在ChunkCache中
158158
- loadChunkActualIOSize: 从磁盘中读取Chunk时耗费的磁盘IO(单位为bytes)
159+
160+
自V2.0.9起,在 FragmentInstance 中,将增加如下信息:
161+
- OutputPlanNodeId:表示sink节点对应的下游接收数据的节点,仅在sink节点中出现
162+
- sizeInBytes:表示exchange节点中接收到的TsBlock的字节(仅计算数据占用大小),仅在exchange节点中出现
163+
- tableScan节点过滤数据相关字段,仅在filter下推到tableScan中才有效,且仅在tableScan节点中出现:
164+
- TimeSeriesIndexFilteredRows : 通过序列元数据(TimeseriesMetadata)过滤掉的数据行数
165+
- ChunkIndexFilteredRows: 通过列块元数据(ChunkMetadata)过滤掉的数据行数
166+
- PageIndexFilteredRows:通过页头内部(PageHeader)过滤掉的数据行数
167+
- RowScanFilteredRows:一行行检查数据时候被过滤掉的行数(仅在带有verbose时才会展现)
159168

160169

161170
##### 特别说明

0 commit comments

Comments
 (0)