ClickHouse查看执行计划(EXPLAIN语法)

本文详细介绍了EXPLAIN命令的不同版本(AST、SYNTAX、QUERYTREE、PLAN、PIPELINE),展示了如何使用它们获取查询计划,包括抽象语法树、语法优化建议和执行计划示例。重点讲解了添加索引和分区对查询性能的影响。

1.EXPLAIN 语法示例

EXPLAIN [AST | SYNTAX | QUERY TREE | PLAN | PIPELINE | ESTIMATE | TABLE OVERRIDE] [setting = value, ...]
    [
      SELECT ... |
      tableFunction(...) [COLUMNS (...)] [ORDER BY ...] [PARTITION BY ...] [PRIMARY KEY] [SAMPLE BY ...] [TTL ...]
    ]
    [FORMAT ...]

查询计划的类型说明:
 AST(抽象语法树):在AST级别优化之后的查询文本 
 SYNTAX(语法优化):在AST级别优化之后的查询文本,返回优化后的sql 
 QUERY TREE(查询树):在查询树级别优化之后的查询树
 PLAN(执行计划):查询执行计划,默认是此值
 PIPELINE(管道):查询执行管道

1.1AST(抽象语法树)

查询语法树执行计划

explain AST SELECT
            path,code,v1
        FROM
            autorun_t_index
        WHERE
            index_id = 1227
          AND cluster_id =27
          AND code IN('queue_name', 'queue_allocatedmb', 'queue_availablemb','queue_allocatedvcores','queue_availablevcores')
          AND update_date IN(SELECT MAX(update_date) FROM autorun_t_index WHERE index_id = 1227 AND cluster_id = 27 and update_date <='2023-08-04 01:38:48')

展示结果:

  SelectQuery (children 3)
   ExpressionList (children 3)
    Identifier path
    Identifier code
    Identifier v1
   TablesInSelectQuery (children 1)
    TablesInSelectQueryElement (children 1)
     TableExpression (children 1)
      TableIdentifier autorun_t_index
   Function and (children 1)
    ExpressionList (children 4)
     Function equals (children 1)
      ExpressionList (children 2)
       Identifier index_id
       Literal UInt64_1227
     Function equals (children 1)
      ExpressionList (children 2)
       Identifier cluster_id

       Literal UInt64_27
     Function in (children 1)
      ExpressionList (children 2)
       Identifier code
       Literal Tuple_('queue_name', 'queue_allocatedmb', 'queue_availablemb', 'queue_allocatedvcores', 'queue_availablevcores')
     Function in (children 1)
      ExpressionList (children 2)
       Identifier update_date
       Subquery (children 1)
        SelectWithUnionQuery (children 1)
         ExpressionList (children 1)
          SelectQuery (children 3)
           ExpressionList (children 1)
            Function MAX (children 1)
             ExpressionList (children 1)

              Identifier update_date
           TablesInSelectQuery (children 1)
            TablesInSelectQueryElement (children 1)
             TableExpression (children 1)
              TableIdentifier autorun_t_index
           Function and (children 1)
            ExpressionList (children 3)
             Function equals (children 1)
              ExpressionList (children 2)
               Identifier index_id
               Literal UInt64_1227
             Function equals (children 1)
              ExpressionList (children 2)
               Identifier cluster_id
               Literal UInt64_27
             Function lessOrEquals (children 1)
              ExpressionList (children 2)
               Identifier update_date
               Literal '2023-08-04 01:38:48'
 Identifier TabSeparatedWithNamesAndTypes

1.2SYNTAX(语法优化)

语法优化前执行sql

explain SYNTAX  SELECT
            path,code,v1
        FROM
            autorun_t_index
        WHERE
            index_id = 1227
          AND cluster_id =27
          AND code IN('queue_name', 'queue_allocatedmb', 'queue_availablemb','queue_allocatedvcores','queue_availablevcores')
          AND update_date IN(SELECT MAX(update_date) FROM autorun_t_index WHERE index_id = 1227 AND cluster_id = 27 and update_date <='2023-08-04 01:38:48')

语法优化后推荐的sql

SELECT
    path,
    code,
    v1
FROM autorun_t_index
WHERE (index_id = 1227) AND (cluster_id = 27) AND (code IN ('queue_name', 'queue_allocatedmb', 'queue_availablemb', 'queue_allocatedvcores', 'queue_availablevcores')) AND (update_date IN ((
    SELECT max(update_date)
    FROM autorun_t_index
    WHERE (index_id = 1227) AND (cluster_id = 27) AND (update_date <= '2023-08-04 01:38:48')
) AS _subquery132))

1.3QUERY TREE(查询树)

1.4PLAN(执行计划)

默认值就是PLAN,一般用来查看sql的执行计划,是否使用引擎,分区,索引等信息

未添加索引前

explain  PLAN  SELECT
            path,code,v1
        FROM
            autorun_t_index
        WHERE
            index_id = 1227
          AND cluster_id =27
          AND code IN('queue_name', 'queue_allocatedmb', 'queue_availablemb','queue_allocatedvcores','queue_availablevcores')
          AND update_date IN(SELECT MAX(update_date) FROM autorun_t_index WHERE index_id = 1227 AND cluster_id = 27 and update_date <='2023-08-04 01:38:48')

未添加索引查询计划

Expression (Projection)
  CreatingSets (Create sets before main query execution)
    Expression (Before ORDER BY)
      Filter (WHERE)
        SettingQuotaAndLimits (Set limits and quota after reading from storage)
          ReadFromStorage (Log)
    CreatingSet (Create set for subquery)
      Expression ((Projection + Before ORDER BY))
        Aggregating
          Expression (Before GROUP BY)
            Filter (WHERE)
              SettingQuotaAndLimits (Set limits and quota after reading from storage)
                ReadFromStorage (Log)

添加引擎,分区后优化结果

Expression ((Projection + Before ORDER BY))
  SettingQuotaAndLimits (Set limits and quota after reading from storage)
    ReadFromMergeTree

1.5PIPELINE(管道)

官网示例

EXPLAIN PIPELINE SELECT sum(number) FROM numbers_mt(100000) GROUP BY number % 4;

执行结果:

(Expression)
ExpressionTransform
  (Aggregating)
  Resize 4 → 1
    AggregatingTransform × 4
      (Expression)
      ExpressionTransform × 4
        (SettingQuotaAndLimits)
          (ReadFromStorage)
          NumbersMt × 4 0 → 1


 

### 可能的原因 - **版本不支持**:explain 功能从 20.6 版本才成为正式功能,若使用的是之前的版本,在正常情况下使用 explain 可能会失败,需到 log 日志中查看执行过程 [^5]。 - **语法错误**:explain 有特定的语法格式,如 `explain [plan | ast | syntax | pipeline] [setting1=value1, setting2=value2,...] select ... [format ...]`,若输入的语句不符合该格式,会导致执行失败 [^5]。 - **日志配置问题**:在使用 explain 查看执行计划时,若 `send_logs_level` 等日志相关参数设置不正确,或者重定向操作有误,可能影响 explain 功能正常执行 [^4]。 ### 解决办法 - **检查版本**:确认使用的 ClickHouse 版本,若版本低于 20.6,需到 log 日志中查看执行过程;若版本支持,可正常使用 explain 功能 [^5]。 - **检查语法**:严格按照 explain语法格式编写 SQL 语句,例如查看执行SQL 是否使用 Projection 功能,可使用 `explain select name from song_info where name = '独家女孩';` 这样的语句 [^3][^5]。 - **检查日志配置**:确保 `send_logs_level` 等参数设置正确,如指定日志等级为 trace,同时正确进行重定向操作,如将 SQL 语句重定向至 clickhouse - client 进行查询,将查询结果重定向到空设备吞掉以便观察日志 [^4]。 ### 示例代码 以下是使用 explain 查看执行计划的示例: ```sql -- 查看执行SQL 是否使用 Projection 功能 explain select name from song_info where name = '独家女孩'; -- 使用 explain 查看执行计划,设置日志等级为 trace send_logs_level=trace <<< "explain select * from table_name" | clickhouse-client > /dev/null ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值