操作场景
DatabaseClaw 需要连接您的数据库实例才能执行诊断和运维操作。通过数据源管理功能，您可以为当前 Claw 实例添加、编辑、测试和删除数据库连接。本文介绍如何在对话页面管理数据源。
背景信息
数据源是 DatabaseClaw 实例与数据库之间的连接配置。每个数据源包含数据库类型、地域、实例选择、数据库账号和密码等信息。DatabaseClaw 通过数据源连接到您的数据库实例，获取运维所需的信息并执行相关操作。
数据库连接密码通过密钥管理服务（KMS）加密存储，查看时脱敏显示，保障凭证安全。
实现机制
数据源管理的核心流程如下：
1. 实例列表获取：用户选择数据库类型和地域后，系统通过
DatabaseClawDefaultRole 服务角色（第一类凭证）调用对应云产品 API 获取实例列表。2. 凭证加密：用户输入的数据库账号和密码（第二类凭证）通过腾讯云 KMS 服务加密后存储，原始密码不会明文落盘。
3. 连通性测试：系统使用 Claw Agent 从 VPC 内网向目标数据库发起连接测试，验证网络连通性和凭证有效性。
4. 绑定关系：数据源与 Claw 实例一对多关联，每个实例可绑定多个不同类型和地域的数据源。
使用限制
限制项 | 限制说明 |
支持的数据库类型 | 云数据库 MySQL、分布式缓存数据库 Distributed Cache、云数据库 MongoDB、TDSQL-C MySQL 版。 |
数据源作用域 | 数据源与 Claw 实例强绑定，不同实例之间的数据源配置相互独立。 |
密码存储方式 | 密码通过 KMS 加密存储，查看时脱敏显示。 |
实例列表获取 | 选择地域后，系统自动通过服务角色权限加载该地域下对应类型的实例列表。 |
注意事项
数据源配置中的数据库账号需具备对目标数据库的读取和诊断权限，建议使用专用的运维只读账号。
删除数据源后，依赖该数据源的 Skill 将无法正常执行。
前提条件
已创建 DatabaseClaw 实例，且实例状态为运行中。
DatabaseClaw 实例与目标数据库在同一 VPC 下，或已打通网络。
目标数据库的安全组已放通来自 DatabaseClaw 所在子网的访问。
首次创建实例时已完成服务角色
DatabaseClaw_QCSRoleInResourceAccess 的授权。操作步骤
添加数据源
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击数据源。
5. 在右侧弹框上方单击添加数据源。
6. 按照以下参数配置数据源。
参数 | 是否必填 | 说明 |
数据库类型 | 是 | 选择数据库类型：MySQL、Distributed Cache、MongoDB 或 TDSQL-C MySQL。 |
地域 | 是 | 选择数据源所在的地域。选择地域后系统自动加载该地域下对应类型的实例列表。 |
实例 | 是 | 从下拉列表中选择目标数据库实例。实例列表通过服务角色权限动态获取，无需手动输入实例 ID。 |
数据库账号 | 是 | 输入数据库连接账号。 |
数据库密码 | 是 | 输入数据库连接密码。密码将通过 KMS 加密存储。 |
7. 单击测试连接，验证凭证有效性和网络连通性。
8. 测试通过后，单击确定，完成数据源添加。
编辑数据源
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击数据源。
5. 在数据源管理弹窗中，找到目标数据源，在操作列单击编辑。
6. 修改数据库账号或密码。
7. 单击测试连接，验证凭证有效性和网络连通性。
8. 测试通过后，单击确定，完成修改。
测试数据源连通性
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击数据源。
5. 在数据源管理弹窗中，找到目标数据源，在操作列单击连通性测试。
系统将重新验证数据源的网络连通性和凭证有效性。
删除数据源
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击数据源。
5. 在数据源管理弹窗中，找到目标数据源，在操作列单击删除，阅读重启实例注意事项，确认无误后，单击删除。
注意：
删除数据源后，将无法恢复，依赖该数据源的 Skill 将无法正常执行。请确认删除前已排查影响范围。
后续步骤
数据源配置完成后，即可通过对话功能让 AI 助手执行数据库诊断和运维操作。
如需了解凭证管理的完整方案，请参见凭证管理。
相关操作
使用对话功能
凭证管理
对应的 API 接口
API 名称 | 说明 |
AddDataSource | 添加数据源。 |
ModifyDataSource | 修改数据源（更新账号/密码）。 |
DeleteDataSource | 删除数据源。 |
TestDataSourceConnectivity | 测试数据源连通性。 |
DescribeDataSourceConnectivityResult | 查询连通性测试结果。 |
DescribeDataSourceList | 查询数据源列表。 |
常见问题
连通性测试失败怎么办？
请依次检查：
1. 数据库账号和密码是否正确。
2. DatabaseClaw 实例与目标数据库是否在同一 VPC 下，或已打通网络。
3. 目标数据库的安全组是否允许来自 DatabaseClaw 所在子网的访问。
数据源的密码是否安全？
数据源密码通过腾讯云密钥管理服务（KMS）加密存储，查看时脱敏显示。密码在传输和存储过程中均进行加密保护。
支持手动输入实例 ID 吗？
当前版本通过服务角色权限自动获取实例列表，选择地域和数据库类型后，从下拉列表中选择目标实例即可，无需手动输入实例 ID。
