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