tencent cloud

TDSQL-C MySQL 版

动态与公告
产品动态
产品公告
新手指引
产品简介
产品概述
产品优势
应用场景
产品架构
产品规格
实例类型
产品功能列表
数据库版本
地域和可用区
常用概念
使用限制
使用规范建议
自研内核
内核概述
内核版本更新动态
内核优化版本
功能类特性
性能类特性
安全类特性
稳定性特性
分析引擎特性
内核问题检查与修复
购买指南
计费概述
产品价格
创建集群
变配说明
续费说明
欠费说明
退费说明
按量转包年包月
按量转 Serverless
增值服务计费说明
查看费用账单
快速入门
数据库审计
简介
查看审计实例列表
开通审计服务
查看审计日志
日志投递
配置事后告警
修改审计规则
修改审计服务
关闭审计服务
审计规则模板
查看审计任务
授权子用户使用数据库审计
Serverless 服务
Serverless 简介
创建和管理 Serverless 版集群
弹性管理工具
Serverless 资源包
多可用区部署
配置变更
常见问题
Serverless 成本预估器
操作指南
操作总览
控制台切换集群页面视图
数据库连接
实例管理
配置变更
实例形态管理
集群管理
只读实例管理
数据库代理
账号管理
数据库管理
数据库管理工具(DMC)
参数配置
多可用区部署
全球数据库
备份与恢复
操作日志
迁移数据
并行查询
列存索引 CSI
分析引擎
数据库安全和加密
监控与告警
SQL 基本操作
使用 SCF 连接 TDSQL-C MySQL 版
标签
实践教程
TDSQL-C MySQL 版数据库审计等保实践
通过 DTS 升级数据库版本 MySQL5.7至8.0
TDSQL-C MySQL 版使用规范
新版本控制台
数据库代理多连接地址实现多 RO 组
数据库代理的优势
如何选择存储空间计费模式
通过 DTS 构建异地灾备
为集群创建 VPC
如何进行数据恢复
如何解决 CPU 使用率高的问题
如何授权子用户查看监控
白皮书
安全白皮书
性能白皮书
故障处理
连接相关
性能相关
API 文档
History
Introduction
API Category
Making API Requests
Instance APIs
Multi-Availability Zone APIs
Other APIs
Audit APIs
Database Proxy APIs
Backup and Recovery APIs
Parameter Management APIs
Billing APIs
serverless APIs
Resource Package APIs
Account APIs
Performance Analysis APIs
Data Types
Error Codes
常见问题
基础概念
购买与计费
兼容与格式
连接与网络
功能特性
控制台操作
数据库表
性能与日志
数据库审计
TDSQL-C MySQL 版和云数据库 MySQL 有什么区别
相关协议
服务等级协议
服务条款
TDSQL-C 政策
隐私政策
数据处理和安全协议
通用参考
标准与认证
词汇表
联系我们

statement outline

PDF
聚焦模式
字号
最后更新时间: 2025-12-26 19:10:52

功能介绍

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 的 idx2 索引)。

删除某条 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 后可能导致的性能回退,在可接受的性能回退范围下做绑定,必要时和内核人员商议。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈