tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
TDSQL-C MySQL 版
    文档
    Download PDF

    statement outline

    最后更新时间：2024-04-25 11:19:31
    下载PDF

      功能介绍

      SQL 调优是数据库性能优化中非常重要的一环。为了避免优化器无法选择合适的执行计划所带来的影响，TXSQL 提供了 OUTLINE 功能，供用户绑定执行计划。TDSQL-C MySQL 数据库有通过 HINT 来人为绑定执行计划的功能，HINT 信息包含 SQL 采用何种优化规则，执行何种算法，数据扫描采用何种索引等。OUTLINE 主要依靠 HINT 来指定查询计划，我们提供系统表 mysql.outline 让用户添加计划绑定规则，通过开关（cdb_opt_outline_enabled）控制是否开启该功能。

      支持版本

      内核版本 TDSQL-C MySQL 版8.0 3.1.10及以上。

      适用场景

      当线上执行计划走错，如线上执行计划选错索引，但业务又不想修改 SQL 重新发版本解决的场景。

      使用说明

      OUTLINE 语法设置采用新的语法形式：
      设置 OUTLINE 信息：outline "sql" set outline_info "outline";
      清空 OUTLINE 信息：outline reset ""; outline reset all;
      刷新 OUTLINE 信息：outline flush;
      下面介绍 OUTLINE 的主要使用方法，用以下 schema 为例说明：
      create table t1(a int, b int, c int, primary key(a));
      create table t2(a int, b int, c int, unique key idx2(a));
      create table t3(a int, b int, c int, unique key idx3(a));
      参数名
      动态
      类型
      默认
      参数值范围
      说明
      cdb_opt_outline_enabled
      yes
      bool
      false
      true/false
      是否打开 outline 功能
      说明：
      用户目前无法直接修改以上参数的参数值，如需修改可 提交工单 进行修改。

      绑定 OUTLINE

      直接绑定 OUTLINE 的方式是将一条 SQL 替换成另一条，SQL 的语义没有改变，仅是加入了一些 HINT 信息告知优化器如何去执行。 语法形式为：outline "sql" set outline_info "outline";，注意 outline_info 后的字符串应该以 "OUTLINE:" 开头，"OUTLINE:" 之后为加入 HINT 之后的 SQL。如给 select *from t1, t2 where t1.a = t2.a 这条 SQL 的 t2 表加上 a 列上的索引。
      outline "select* from t1, t2 where t1.a = t2.a" set outline_info "OUTLINE:select * from t1, t2 use index(idx2) where t1.a = t2.a";

      绑定 optimizer hint

      为了功能更加灵活，TXSQL 允许向 SQL 中增量添加 optimizer hint，同样的功能也可以通过直接绑定 outline 实现。 语法形式为：outline "sql" set outline_info "outline";，注意 outline_info 后的字符串应该以 "OPT:" 开头，"OPT:" 之后为需要加入的 optimizer hint 信息。如给 select *from t1 where t1.a in (select b from t2) 这条 SQL 指定 MATERIALIZATION/DUPSWEEDOUT 的 SEMIJOIN。
      outline "select* from t1 where t1.a in (select b from t2)" set outline_info "OPT:2#qb_name(qb2)";
      outline "select * from t1 where t1.a in (select b from t2)" set outline_info "OPT:1#SEMIJOIN(@qb2 MATERIALIZATION, DUPSWEEDOUT)";
      向原始 SQL 语句中添加 OPTIMIZER 的 HINT，仅支持一次添加一个 HINT，语法上需注意三点：
      OPT 关键字应该紧随在"之后。
      需要绑定的新语句前必须是':'。
      需要添加两个字段（query block 的号码 #optimizer hint 的字符串），中间必须用#分割（ie. "OPT:1#max_execution_time(1000)"）。

      绑定 index hint

      为了功能更加灵活，TXSQL 允许向 SQL 中增量添加 index hint，同样的功能也可以通过直接绑定 outline 实现。 语法形式为：outline "sql" set outline_info "outline";，注意 outline_info 后的字符串应该以 "INDEX:" 开头，"INDEX:" 之后为需要加入的 index hint 信息。 下面举个例子：给 select *from t1 where t1.a in (select t1.a from t1 where t1.b in (select t1.a from t1 left join t2 on t1.a = t2.a)) 这条 SQL 的 query block 3 上数据库 test 下 t1 表增加 USE INDEX 的索引 idx1，类型为 FOR JOIN。
      outline "select* from t1 where t1.a in (select t1.a from t1 where t1.b in (select t1.a from t1 left join t2 on t1.a = t2.a))" set outline_info "INDEX:3#test#t1#idx1#1#0";
      向原始 SQL 语句中添加 INDEX 的 HINT，仅支持一次添加一个 HINT，语法上注意四点：
      INDEX 关键字应该紧随"之后。
      需要绑定的新语句前必须是':'。
      需要添加五个字段（query block 的号码 #db_name#table_name#index_name#index_type#clause）。
      其中 index_type 还有三个值（0为 INDEX_HINT_IGNORE、1为 INDEX_HINT_USE、2为 INDEX_HINT_FORCE），其中 clause 有三个值（1为 FOR JOIN、2为 FOR ORDER BY、3为 FOR GROUP BY），中间必须用#分割（ie. "INDEX:2#test#t2#idx2#1#1" 表示将第2个 query block 中的 test.t2 表中绑定类型为 USE INDEX FOR JOIN 的 idx1 索引）。

      删除某条 SQL 对应的 OUTLINE 信息

      TXSQL 允许用户删除某一条 SQL 语句的 OUTLINE 绑定信息。 语法为：outline reset "sql";，如将 select *from t1, t2 where t1.a = t2.a 的 outline 信息删除：outline reset "select* from t1, t2 where t1.a = t2.a";。

      清空所有 OUTLINE 信息

      TXSQL 允许用户删除内核中所有 OUTLINE 绑定信息。语法为：outline reset all，执行语句为：outline reset all;。
      线上业务中有时候会有一些非常特定的问题，需要强制绑定索引，这里可以直接设置 OUTLINE 去绑定。 需要分析设置 OUTLINE 后可能导致的性能回退，在可接受的性能回退范围下做绑定，必要时和内核人员商议。
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款