当需要评估 DDL 变更对查询性能、业务 SQL 等场景的风险和影响时，可购买和使用 DDL 变更风险评估智能体，低成本试错确保变更安全可控。
本文为您介绍配置 DDL 变更评估任务和查看评估报告的步骤。配置 DDL 变更信息后，智能体通过变更前预检评估、变更中风险评估和变更后 SQL 影响仿真预测三个阶段逐步深入分析评估变更风险。
智能体规划和执行任务步骤说明
规划步骤 | 子步骤 | 说明 |
变更预测评估 | 信息收集 | 展示已获取的数据库和表结构信息，以及负载采样数据，以帮助我们更好地为您提供优化建议和推荐变更窗口。 获取信息包括实例基本信息、实例全局变量信息、DDL 变更表结构、实例空间信息和实例过去24小时历史负载。 |
| DDL 分析和推荐窗口 | 基于信息收集阶段获取的相关信息，帮助您完成 DDL 优化，并基于实例级别和表级别的历史负载情况，向您推荐最优的变更窗口。 DDL 优化建议：包括语法与数据库版本兼容校验、执行算法校验、表重建评估、锁表判断、操作耗时预估、大表操作风险并总结优化建议。 变更窗口推荐：引入风险因子的概念，将风险因子值最小的5分钟区间作为最佳变更窗口。展示风险因子计算逻辑、风险因子全量统计分布、风险因子统计表、全局最优窗口、用户区间最优窗口。 |
| 变更预检评估报告输出 | 将基于变更概要、环境分析、DDL 优化建议和推荐执行窗口内容生成 DDL 变更的简易报告。帮助您直观了解到 DDL 变更信息。 |
变更中风险仿真评估 | 实例克隆和流量回放 | 按照 DDL 变更计划的执行时间前15分钟克隆源前一天的实例数据到新目标实例，并以此为基础，全量仿真回放实际流量，模拟 DDL 变更执行前后30分钟的真实业务负载。 |
| 变更中风险仿真评估报告 | 根据流量回放的结果，输出 DDL 变更风险仿真评估报告。 评估报告包括： 变更概览：包括源实例 ID/名称、流量回放时段、模拟 DDL 执行时间点、回放 SQL 条数、重放顺序准确性。 风险评估关键指标：包括 DDL 执行结果分析、资源使用率风险分析、查询性能和同步延迟风险分析、综合风险评分。 综合风险评分：包括风险等级，安全执行建议及风险说明。其中风险等级说明如下： 低风险：DDL 执行顺利，资源使用率和 SQL 查询性能保持稳定。 中风险：DDL 执行顺利，资源使用率或者 SQL 查询性能有较明显波动但不到瓶颈。 高风险：DDL 执行失败，或者造成资源使用率或 SQL 查询性能到达瓶颈。 |
变更后 SQL 影响仿真预测 | 实例克隆和流量回放 | 根据过去完整的业务周期（7天），分别克隆7个原实例，进行真实流量回放，模拟 DDL 变更后一个业务周期内 SQL 语句的执行情况。 |
| 变更后 SQL 影响仿真预测报告 | 基于在完成 DDL 变更的克隆实例上回放过去7天的真实流量，并生成性能评估报告。 性能评估报告包括： 回放概要：包括数据库、表、DDL 类型、回放 SQL 数量、回放数据周期。 分析结论与建议：包括 SQL 模板高风险变化率、性能优化 SQL 模板数、性能劣化 SQL 模板数、SQL 模板回放置信率、综合建议。 SQL 模板风险及性能详细对比：包括风险变化情况、性能改善情况。 影响回放置信率的 SQL 模板列表：包括回放未覆盖的 SQL 模板列表、回放出错 SQL 模板列表。 |
使用限制
限制说明
账户级限制：单个 UIN 最多可同时运行3个 DDL 变更评估任务（跨对话窗口共享额度）。
对话级限制：单个对话窗口同一时间仅允许提交1个 DDL 变更评估任务。
发起 DDL 变更风险评估后，请不要关闭或退出页面，否则需要重新发起评估。
支持范围
支持数据库类型： 云数据库 MySQL
支持的 DDL 变更语句类型：
添加索引（如：ALTER TABLE ... ADD INDEX ... ）
删除索引（如：ALTER TABLE ... DROP INDEX ... ）
变更字段类型（如：ALTER TABLE ... MODIFY ... ）
支持的地域：北京、北京金融、南京、成都、上海、深圳、清远、广州
前提条件
服务授权说明
DDL 变更风险评估智能体依赖服务授权以获取拉取实例备份集等操作的权限。用户需先完成服务授权，方可购买智能体实例。
授权账号权限说明
注意：
服务授权是主账号维度，主账号及主账号下的子账号仅需要授权一次即可。
主账号：无需额外权限，购买时直接单击立即授权、同意授权即可。
子账号：
拥有预设策略 QcloudCamSubaccountsAuthorizeRoleFullAccess，则操作与主账号一致。
没有预设策略 QcloudCamSubaccountsAuthorizeRoleFullAccess，需先由主账号或管理员账号进行该策略的授权。
操作步骤
步骤一：购买 DDL 变更风险评估智能体实例
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择智能体中心。
3. 在智能体名称对应的操作列单击购买。
4. 进行服务授权。
说明：
4.1 在弹出的对话框中单击立即授权。
4.2 单击同意授权。
5. 配置智能体实例信息，单击确定。
实例名称（必选）：请输入智能体实例名称。
标签（可选）：选择标签键和标签值。同时，支持单击键值粘贴板，粘贴键值对，单击提交，自动填充标签。最大支持添加5个键值对。
步骤二：发起 DDL 变更风险评估
1. 在左侧导航栏，选择我的实例。
2. 在购买的 DDL 变更风险评估智能体实例对应的操作列单击对话。
3. 仔细阅读 DDL 变更风险预估智能体数据使用授权通知，单击同意。
4. 在对话窗口，单击发起 DDL 变更风险预估。
5. 配置任务参数，配置完成后单击确认 DDL 变更信息。
参数说明如下表所示。
参数名 | 说明 |
DDL 类型选择 | 选择您将会进行 DDL 变更的方式。在克隆环境中进行仿真执行时，不同的变更方式采用对应的方式执行 DDL。 普通 DDL：即直接执行 DDL 语句进行变更。 pt-osc 在线变更：即使用 pt-osc 开源工具进行变更。 选择 pt-osc 在线变更，还需要选择每秒拷贝行数。 说明： 选择 pt-osc 在线变更时，输入的 DDL 语句仅支持以 ALTER TABLE 开头。 |
DDL 语句 | 请输入待评估风险的 DDL 语句以及其他信息。 每行一条以 ; 结尾，仅支持删除索引和新增索引。 |
地域 | 选择要关联的实例所属地域。 |
实例 ID | 输入云上实例 ID，示例：cdb-xxxxxxxx。 请确保实例与购买智能体实例使用的 UIN 账号一致。 |
时间范围 | 请选择 DDL 变更的执行时间范围。 说明： 如果您选择的时间段过窄（如仅1小时），可能会影响 DDL 变更的执行窗口。建议选择一个较大的时间范围以确保能够避开数据库的高负载时段。 |
页面实时展示执行阶段和阶段执行结果，评估完成后在页面右侧直接展示 DDL 变更事前综合风险评估报告。
6. 可在左侧页面分别单击获取实例基本信息、获取实例全局变量信息、获取 DDL 变更表结构、获取实例空间信息、获取实例历史负载、DDL 优化建议、变更窗口推荐、变更预检评估报告输出，在右侧页面查看具体执行信息。
7. 执行完成后单击确认进行变更中风险仿真评估，继续执行下一阶段任务。
步骤三：执行变更风险评估
1. 变更中风险仿真评估。
1.1 确认流量回放的 DDL 执行时间是否为推荐的变更窗口。
1.2 自动执行变更中风险仿真评估。
1.3 执行完成后单击确认进行变更后 SQL 影响仿真预测，继续执行下一阶段任务。
2. 变更后 SQL 影响仿真预测。
2.1 自动执行变更中风险仿真评估。
2.2 执行完成后，查看变更后 SQL 操作影响仿真预测报告。
