AI Studio 的智能诊断结合 ByteHouse 的监控指标、日志和查询信息，帮助您诊断查询失败、慢 SQL、计算组资源异常等运行问题，并提供分析依据、可能原因和处理建议。本文介绍如何准备诊断信息、发起诊断、查看结果，以及从业务页面快速进入诊断。

• 已登录火山引擎控制台并进入 ByteHouse 云数仓版，选择待诊断资源所在的地域和环境。AI Studio 的支持地域请参见支持的地域。
• 当前账号具备待诊断资源及相关运行信息的访问权限。诊断需要在所选环境和资源范围内获取信息。
• 明确要分析的对象、异常现象和时间范围。根据任务准备查询 ID、计算组 ID、数据库名或表名。

诊断内容由大模型生成，仅供辅助分析。智能诊断默认不自动执行终止查询、重启或参数变更等高风险操作；实施诊断建议前，请评估影响并进行验证。完整使用声明请参见声明。

先确定需要解决的问题，再准备对应信息。以下示例中的资源标识为占位内容，使用时请替换为实际值。

• 查询 ID 可从数据查询的报错信息或SQL审计中的目标查询记录获取；也可以通过下文的业务页面诊断入口，自动带入对应查询 ID。
• 计算组诊断请提供目标计算组的实际 ID；表诊断使用“数据库名.表名”，避免同名表造成歧义。
• 排查某次异常时，建议明确开始时间、结束时间和时区。比较前后变化时，同时提供正常时段和异常时段；实际可用于分析的信息以当前能获取的记录为准。

进入诊断模式 #

1. 登录ByteHouse 云数仓版火山引擎控制台，选择待诊断资源所在的地域和环境。
2. 在左侧导航栏选择 AI Studio。
3. 确认当前模式为智能诊断。AI Studio 默认进入该模式。

选择范围并发送问题 #

1. 在输入区的数据源中，选择与本次诊断对象对应的范围，并确认其属于当前所选环境。
2. 在输入框中描述问题，提供对应的资源标识、时间范围和异常现象。例如，排查慢 SQL 时填写实际查询 ID，并补充执行耗时及发生时间。
3. 发送问题。您也可以选择页面提供的快捷诊断问题，在发送前补充模板中的资源标识、时间范围等参数。
4. 等待 AI Studio 返回分析结果；收到补充信息的提示后，在当前会话中补充相应内容。

收到回答后，先确认分析的对象和时间范围，再核对诊断结论。重点检查异常现象、分析依据、可能原因和处理建议：

在同一会话中继续追问 #

针对同一问题，可在当前会话中补充信息或细化分析目标。AI Studio 会结合已有对话继续分析。例如：

• “请说明你判断资源不足的具体依据，以及哪些原因还不能确认。”
• “将这次慢查询与正常时段对比，还需要我提供哪些信息？”
• “请进一步解释该优化建议的适用条件，以及实施后应检查哪些指标。”

需要切换到其他模式或环境时，请新建会话。分析其他查询或表时，明确提供新的对象标识；为避免混淆不同问题的上下文，也可以新建会话。

新建或恢复诊断会话 #

同一问题的补充信息和追问保留在原会话中，便于结合已有分析继续排查。开始新的诊断主题、切换模式或环境时，单击新会话，选择智能诊断及对应的数据源后重新提问。

需要继续此前的诊断时，可在 AI Studio 独立页面恢复历史会话：

1. 在左侧会话区找到目标历史会话；也可以在搜索框中输入会话标题的关键词进行查找。
2. 选择目标会话，查看已有问题、分析依据和建议，确认其诊断对象与本次问题一致。
3. 在原会话中说明新增信息或问题变化，继续提问。分析新的时间范围时，明确补充新的起止时间，避免将此前时段的结论直接用于当前问题。

示例：排查一条慢 SQL #

假设某条 SQL 本次耗时约 60 秒，此前同类查询通常约 10 秒。下面以该异常为例，说明如何发起诊断、补充背景、核对判断并验证建议。示例耗时和资源标识仅用于说明提问方式，请替换为实际信息。

1. 确定目标查询：在左侧导航栏诊断优化 > 审计日志 > SQL 审计 > SQL 历史中找到本次耗时较长的记录，单击智能诊断。右侧弹出AI Studio面板将自动带入查询 ID。
   
2. 补充异常背景：在同一会话中说明本次执行时间、实际耗时和正常情况，例如：“这次查询耗时约 60 秒，此前同类查询通常约 10 秒。请分析耗时增加的原因，列出依据，并说明哪些原因仍需要核实。”
3. 核对判断依据：查看回答引用的查询信息、运行指标或日志是否对应目标记录和异常时段。若需与正常执行对比，可继续提供一条正常查询的查询 ID，例如：“正常查询 ID 为 query_normal_example，请对比两次执行的信息；无法获取的内容请说明。”
4. 验证处理建议：根据分析结果追问建议的适用条件和验证方法，例如：“实施这项优化前需要检查什么？如何确认优化有效？”评估后在测试环境中验证，并对比相同业务口径下的耗时和结果，再决定是否应用到生产环境。

已有明确诊断对象时，可以从对应业务页面直接发起诊断。入口会在页面右侧打开 AI Studio 面板，并自动带入当前对象。打开后请确认带入的对象正确，再按需要补充异常现象和时间范围。

诊断查询报错 #

1. 在数据开发 > 数据查询页面，运行工作表中的SQL失败。
2. 在查询结果报错信息右侧单击智能诊断。
   
3. 在右侧 AI Studio 面板中查看诊断。系统自动带入失败查询的查询 ID，并分析错误原因和处理建议；需要时可在同一会话中补充信息。

诊断 SQL 审计记录 #

1. 进入诊断优化 > SQL 审计，在SQL 历史或运行中的查询中找到目标记录。
2. 单击该记录操作列中的智能诊断。
   
3. 在右侧 AI Studio 面板中核对自动带入的查询 ID，查看诊断结果，并按需要补充耗时、异常现象或发生时间。

诊断数据库健康状态 #

1. 进入数据资产 > 数据库，选择目标数据库。
2. 在数据库详情页单击数据库智能诊断。
   
3. 右侧 AI Studio 面板自动带入数据库名称并发起诊断。查看结果后，可继续说明需要重点分析的表、异常现象或时间范围。

诊断数据表健康状态 #

1. 进入数据资产 > 数据库，选择待诊断数据表。
2. 在表详情页单击表健康度诊断。
   
3. 右侧 AI Studio 面板自动带入表名并发起诊断。确认数据库和表的范围正确，查看分析依据与建议。