#连接数据库

Data Agent 支持连接多个数据库和数据源，以便统一管理并在语义层中建模。在完成安装部署后，可以通过控制台的新页面独立管理所有数据源。

#页面入口

1. 点击顶部导航栏的 系统搭建。
2. 在左侧侧边栏依次选择 数据管理 → 数据源管理，进入“连接数据库”页面。

#创建数据源

1. 点击右上角的 添加 按钮，选择要连接的数据库类型（MySQL、PostgreSQL、ClickHouse 等）。
2. 填写连接表单：
   • 类型：目标数据库或 API 类型。
   • 只读：建议生产环境均使用只读账号。
   • 主机/IP、端口、数据库：目标实例的连接信息。
   • 用户名、密码：对应账号的认证信息。
   • 高级设置：根据需要配置 schema、连接池、超时时间等。
3. 点击 测试连接，确认 Data Agent 可以访问该数据源。
4. 通过测试后点击 保存。系统会同步元数据并允许你在后续业务建模中选择对应表。

#示例配置

若仅需快速体验，可以使用以下示例数据源：

保存后便可在“业务建模”中选择示例库中的表，进行语义建模与问答测试。

#使用 AI 员工辅助

如果不熟悉连接配置，可点击页面右下角的 表单助理 Avery，使用自然语言描述数据源，例如“连接到内网 MySQL，主机 10.0.0.5，端口 3306，数据库 sales”。Avery 会自动生成连接配置并填入表单，你只需确认并保存即可。

#常见排查

• 测试连接失败：确认数据库已对 Data Agent 服务器 IP 开放访问权限，并检查账号/密码是否正确。
• Schema 列表为空：确保数据库账号具有 SHOW DATABASES 或列举元数据的权限。
• 网络延迟导致超时：在高级设置中适当增大超时时间，或将 Data Agent 部署在更靠近数据库的网络环境。

完成数据库连接后，可继续前往《业务建模流程总览》配置语义模型，随后在 智能问答 中验证效果。