本文为您介绍开启 AI 优化器，以及 AI 优化器页面相关字段说明。
开启 AI 优化器
说明：
温馨提示，此功能当前处于白名单灰度阶段，若您在控制台暂未看到功能入口，敬请耐心等待，如有疑问，您可 提交工单 反馈。
新购集群时开启 AI 优化器为集群维度，新购时集群内的所有实例均自动开启此功能。
存量集群开启 AI 优化器为实例维度，可选择集群下任一实例（支持多选）进行功能的开启。
场景1：新购集群时开启 AI 优化器
若您要购买预置资源集群，详细操作可以参考 创建集群。
若您要购买 Serverless 集群，详细操作可以参考 创建 Serverless 版集群。
场景2：存量集群开启 AI 优化器
1. 登录 TDSQL-C MySQL 版控制台。
2. 在集群列表，单击集群 ID，进入集群管理页面。
3. 选择 AI 优化器页面，单击立即开启。
4. 在弹窗中，勾选集群下需要开启 AI 优化器的实例（读写实例、只读实例均支持勾选/多选），单击确定。
场景3：对集群下的实例开启 AI 优化器
如果您的集群下有多个实例，且并未全部开启 AI 优化器，您可参考如下操作，对指定实例进行功能的开启。
1. 登录 TDSQL-C MySQL 版控制台。
2. 在集群列表，单击集群 ID，进入集群管理页面。
3. 选择 AI 优化器页面，在右侧单击功能设置。
4. 在弹窗中，开启目标实例的功能按钮即可。
AWR 说明
AWR，即 Automatic Workload Repository，表示收集数据进行训练和优化的相关能力汇总，通过参数以实现各种控制和调整。开启 AI 优化器后，AWR 会同步开启，当前 AWR 提供的参数如下：
参数名称 | 类型 | 取值范围 | 说明 |
txsql_awr_enabled_level | uint | 0 | 2 | 此参数表示 AWR 的级别选择器。 取值为0：不工作。也表示关闭 AI 优化器。 取值为2：启用 AAS 精确时间计时器。也表示开启 AI 优化器，新购或对存量集群通过控制台开启 AI 优化器时，此参数值会默认设置为2。 说明： |
查看 AI 优化器页面（已开启功能）
1. 登录 TDSQL-C MySQL 版控制台。
2. 在集群列表，单击集群 ID，进入集群管理页面。
3. 选择 AI 优化器页面。
查看概览
在 AI 优化器页面上方，可以切换实例进行查看。
选择需要查看的实例后，下方会呈现当前实例的 AI 优化器已累计优化的 SQL 模板个数和运行时间，在您关闭功能之前，AI 优化器将持续进行多轮 AI 训练、探索量化执行计划，降低 SQL 执行时间。
查看指标说明
AI 优化器当前涉及如下性能指标，您可通过对比优化前后的指标数据，清晰感知开启 AI 优化器后的优化效果，以判断该功能当前是否能满足您关于降低 SQL 执行时间的需求。
SQL 总执行时间：展示 SQL 模板优化前后的执行时间对比。根据训练前后执行的 SQL 模板时间累加计算。
平均 CPU 使用率：展示优化前后实例的平均 CPU 使用率的对比情况。根据训练前后实例的平均 CPU 使用率监控计算，可能会由于使用方式的原因，存在优化后高于优化前的情况。
平均慢日志数：展示优化前后实例的平均慢日志数的对比情况。根据训练前后的实例平均慢日志数监控计算，可能会由于使用方式的原因，存在优化后高于优化前的情况。
查看优化明细
支持查看当前实例全部、近24小时、近7天、近30天以及自定义时间范围的优化明细列表，支持在搜索框内输入 SQL 模板进行快速搜索，获取对应优化任务的优化明细。当您需要刷新列表时，通过单击
字段名称 | 说明 |
SQL 模板 | 展示完整的 SQL 模板详情。 |
任务状态 | 展示优化任务的当前状态，支持筛选，值包含： 生效中：表示当前任务处于持续优化中。 已失效：表示当前任务已停止优化，被新任务覆盖或者您进行了手动停止优化操作，均会导致当前任务状态为已失效。 |
优化次数 | 展示当前优化任务的优化次数。 |
累计优化 SQL 数量 | 展示当前优化任务的累计优化 SQL 数量。 |
操作 | 展示可对当前优化任务执行的操作。 停止优化：单击停止优化，可手动停止进行中的优化任务。 恢复训练：单击恢复训练，可手动恢复停止状态的优化任务。 |
查看 SQL 模板详情
在优化明细列表中找到目标优化任务，单击
字段名称 | 说明 |
优化阶段 | 展示历史和当前的优化任务状态，格式为： 2025-04-28 03:04:36 生效中 |
训练轮次 | 展示优化任务的训练轮次，示例：1。 |
平均执行时间（ms） | 展示对应优化阶段的优化前后的平均执行时间，单位：毫秒。 |
平均扫描行数 | 展示对应优化阶段的优化前后的平均扫描行数。 |
优化 SQL 数量 | 展示对应优化阶段的优化 SQL 数量。 |
操作 | 查看：单击查看，可在弹窗中查看对应优化阶段的可视化执行计划详情。 |
查看执行计划详情
在优化明细列表中找到目标优化任务，单击
SQL 语句样例
您可在 SQL 语句样例下了解当前执行计划的 SQL 命令详情。
计划可视化
您可在计划可视化下方了解到优化前后的执行计划情况，包括优化前后的执行时间对比以及扫描行数对比，单击全屏查看可更清晰的查询具体执行计划。
计划表
您可在计划表下了解到优化前后的执行计划表情况，包括优化前后的执行时间对比以及扫描行数对比，单击全屏查看可更清晰的查询计划表明细。
字段名称 | 说明 |
id | SELECT 查询序列号。表示 SQL 中子查询的执行顺序。id 越大越先执行；id 相同则从上往下执行。 示例：1。 |
selectType | 查询类型。表示该步骤的查询复杂度。 示例：PRIMARY。 |
table | 访问的表名。显示这一步正在读取哪张表。 示例：nation。 |
partitions | 匹配的分区。若表是分区表，显示命中的分区名称；非分区表显示 --。 示例：--。 |
type | 访问类型（关键性能指标）。表示 TDSQL-C MySQL 版如何查找数据。 示例：ALL。 |
possibleKeys | 可能使用的索引。AI 优化器认为理论上可以使用的索引列表。 示例：PRIMARY。 |
key | 实际使用的索引。AI 优化器最终决定使用的索引。 示例：PRIMARY。 |
keyLen | 索引键长度。使用的索引字段的总字节数，可用于判断索引是否被完全利用。 示例：4。 |
ref | 索引引用关系。显示与 key 列索引进行比较的列或常量。 示例：tpch1g.nation.n_nationkey。 |
rows | 预估扫描行数。 示例：382。 |
filtered | 过滤百分比。表示经过条件过滤后，剩余行数占预估行数的百分比（0 - 100）。值越小，说明过滤效果越好。 示例：100。 |
extra | 额外执行信息。 示例：Using index。 |
