TIP
这篇文档说明如何把企业数据库接入 Lovrabet，并完成第一次数据库分析。完成后，你可以在 业务数据模型 和 数据集总览 中查看系统识别出的表、字段和关系。
WARNING
当前数据库连接需要 Lovrabet 平台能够访问数据库地址。如果数据库只在内网，先开放公网访问、配置白名单，或按企业网络方案打通后再连接。
开始前准备
开始前准备下面信息：
| 准备项 | 说明 |
|---|---|
| 应用权限 | 你需要能进入目标应用的 RabetBase 管理页面 |
| 数据库地址 | 公网可访问的 host:port，例如 db.example.com:3306 |
| 数据库类型 | MySQL 或 PostgreSQL |
| 数据库名 | 需要接入的库名或 schema 名 |
| 账号和密码 | 建议使用专门的只读或受控账号 |
| 网络白名单 | 数据库侧已允许 Lovrabet 平台访问 |
选择操作方式
<grid> <column width-ratio="0.500000">
</column> <column width-ratio="0.500000">
</column> </grid>
方式一：在工作台操作
Step 1. 打开数据库连接管理
进入目标应用，打开：
RabetBase → 数据库连接管理
点击 连接新数据库。
Step 2. 填写连接信息
按表单填写数据库类型、地址、库名、用户名和密码。
填写完成后，先点击 测试连接。
| 测试结果 | 下一步 |
|---|---|
| 测试成功 | 保存连接 |
| 测试失败 | 检查公网地址、端口、白名单、账号密码和数据库权限 |
Step 3. 发起全量分析
连接保存后，在连接器卡片上点击 全量分析。
等待分析状态变为 成功 或 部分成功。分析时间取决于库表数量和字段复杂度。
Step 4. 查看分析结果
分析完成后，打开：
- 业务数据模型：查看表关系和 ER 结构。
- 数据集总览：查看平台生成的数据集、字段和默认操作。
如果字段名称、表关系或业务含义不准确，后续再进入数据集详情进行校准。
方式二：在 Claude Code 中让 Agent 操作
如果你已经安装 rabetbase CLI 和对应 Skill，也可以把接入需求交给 Claude Code。Agent 会根据需求拆解并调用 CLI。
复制下面的 prompt，把占位内容改成自己的：
请用 rabetbase 帮我把一个数据库接入 Lovrabet，并完成第一次数据库分析。
应用 App Code：<APP_CODE>
数据库类型：<MYSQL 或 POSTGRESQL>
数据库地址：<host:port>
数据库名：<数据库名或 schema>
用户名：<数据库用户名>
密码：<不要在文档中写真实密码，可让我通过安全方式提供>
要求：
1. 先检查当前应用配置和登录状态
2. 创建连接前先预览将要提交的信息，不要在回复里展示真实密码
3. 连接创建后测试连通性
4. 发起全量分析，并查询分析状态直到成功、部分成功或失败
5. 最后告诉我 dbLinkId、分析状态、ER 图入口，以及下一步应该检查什么Agent 正常会完成这些动作：
| 动作 | 结果 |
|---|---|
| 检查应用 | 确认当前目录或 prompt 中的 App Code |
| 创建连接 | 写入数据库连接配置 |
| 测试连接 | 确认平台能访问数据库 |
| 发起分析 | 对库表结构做首次全量分析 |
| 查询状态 | 返回成功、部分成功或失败原因 |
检查结果
[ ] 数据库连接器状态为 已连通。
[ ] 首次分析状态为 成功 或 部分成功。
[ ] 业务数据模型 中能看到表关系。
[ ] 数据集总览 中能看到生成的数据集。
[ ] 至少打开一个数据集详情，确认字段名和字段类型基本正确。
下一步
| 你要做什么 | 继续看 |
|---|---|
| 分析结果不准确，需要校准字段和关系 | 理解逆向结果与业务模型 |
| 后续库表结构变了，需要同步变更 | 库表变更后增量分析 |
| 想让 Agent 基于数据回答问题 | 让 AI 理解你的数据 |
| 想用数据集生成页面、API 或函数 | 从数据到能力 |
常见问题
为什么测试连接失败？
优先检查：
- 数据库地址是否公网可访问。
- 端口是否开放。
- 数据库侧是否配置 Lovrabet 平台访问白名单。
- 用户名、密码、数据库名是否正确。
- 数据库账号是否有读取表结构的权限。
分析结果是部分成功，可以继续吗？
可以先查看 业务数据模型 和 数据集总览。如果核心表已经识别出来，可以继续校准；如果关键表失败，先查看失败原因，再重新分析。
库表后续变更了怎么办？
少量表变更时，不需要重新做全量分析。使用 增量分析 重新同步变更表。
可以连接内网数据库吗？
当前连接前提是 Lovrabet 平台能够访问数据库地址。内网数据库需要先打通网络或提供公网可访问地址后再接入。