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和查询器生成的中间物理计划—在调试时很有帮助，可以看到何时添加或删除执行计划节点，以及InfluxDB如何优化查询。

示例 EXPLAIN ANALYZE VERBOSE

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