EXPLAIN 命令

EXPLAIN 命令会返回指定 SQL 语句的 逻辑计划和 物理计划。

EXPLAIN [ANALYZE] [VERBOSE] statement

• EXPLAIN
  • EXPLAIN 示例
• EXPLAIN ANALYZE
  • EXPLAIN ANALYZE 示例
• EXPLAIN ANALYZE VERBOSE
  • EXPLAIN ANALYZE VERBOSE 示例

EXPLAIN

返回语句的逻辑计划和物理（执行）计划。要输出更多详细信息，请使用 EXPLAIN VERBOSE。

EXPLAIN 不会执行语句。要执行语句并查看运行时指标，请使用 EXPLAIN ANALYZE。

EXPLAIN 示例

EXPLAIN
SELECT
  room,
  avg(temp) AS temp
FROM home
GROUP BY room

EXPLAIN ANALYZE

执行语句并返回该语句的执行计划和运行时指标。报告包含 逻辑计划和 物理计划，并附带执行计数器、生成的行数以及查询执行期间采样的运行时指标。

如果计划需要读取大量数据文件，EXPLAIN 和 EXPLAIN ANALYZE 可能会截断报告中的文件列表。要输出更多信息，包括中间计划和所有扫描的 Parquet 文件的路径，请使用 EXPLAIN ANALYZE VERBOSE。

EXPLAIN ANALYZE 示例

EXPLAIN ANALYZE
SELECT
  room,
  avg(temp) AS temp
FROM home
WHERE time >= '2023-01-01' AND time <= '2023-12-31'
GROUP BY room

EXPLAIN ANALYZE VERBOSE

执行语句并返回执行计划、运行时指标以及有助于调试语句的附加详细信息。

报告包含以下内容

• 逻辑计划
• 附带执行计数器、生成的行数和查询执行期间采样的运行时指标的 物理计划
• EXPLAIN 报告中截断的信息——例如，检索到的所有 Parquet 文件的路径。
• DataFusion 和 Querier 在生成最终物理计划之前生成的所有中间物理计划——这有助于调试，以便查看何时添加或删除了 ExecutionPlan 节点，以及 InfluxDB 如何优化查询。

EXPLAIN ANALYZE VERBOSE 示例

EXPLAIN ANALYZE VERBOSE SELECT temp FROM home
WHERE time >= now() - INTERVAL '7 days' AND room = 'Kitchen'
ORDER BY time