库表变更后增量分析

TIP

这篇文档说明数据库表结构变更后，如何只重新分析变更表，并检查 Lovrabet 中的数据集、模型和页面是否已经同步。

先判断是否适合增量

发生了什么	选择
第一次接入数据库	回到「连接数据库并完成首次分析」，做全量分析
换了数据库、重建了大量表	做全量分析
新增少量表，或少量字段发生变化	做增量分析
只改了某几张表的字段、名称、关联	做增量分析
不确定改了哪些表	先让 Agent 检查差异，再决定分析范围

开始之前

• 数据库连接仍然可访问。Lovrabet 只能连接公网可访问的数据库。
• 你知道本次变更大概涉及哪些表。
• 目标应用里已经完成过第一次数据库分析。

---

方式一：在平台操作

Step 1. 打开数据库连接管理

进入 Lovrabet 工作台，打开目标应用。

1. 点击 RabetBase。
2. 进入 数据库连接管理。
3. 找到需要同步的数据库连接。

确认连接状态正常。如果连接失败，先修复数据库网络、账号或白名单，再做分析。

Step 2. 发起增量分析

在数据库连接卡片上点击 增量分析。

<grid> <column width-ratio="0.500000"> </column> <column width-ratio="0.500000"> </column> </grid>

在弹窗里勾选本次变更的表。可以一次选择多张表。

点击确认后，平台会开始分析这些表。

Step 3. 等待分析完成

分析过程中可以停留在当前页等待，也可以先离开页面。

回到数据库连接管理时，查看任务状态：

状态	含义	下一步
成功	选中的表已完成同步	去检查数据集和页面
部分成功	有些表成功，有些表失败	打开分析结果，处理失败表
失败	本次分析没有完成	查看失败原因后重新发起
分析中	任务仍在执行	等待完成，或在需要时取消

Step 4. 检查同步结果

分析完成后，按下面顺序检查：

• 打开 查看分析结果，确认本次分析的表在结果里。
• 打开 业务数据模型，确认表和关联关系没有丢失。
• 打开 数据集总览，确认字段已经更新。
• 打开依赖这些数据集的页面，抽查字段展示和筛选条件是否正常。

---

方式二：在 Claude Code 中让 Agent 操作

如果已经安装 rabetbase CLI 和对应 Skill，可以把需求直接交给 Claude Code。Agent 会自己拆解步骤并调用 CLI。

复制下面的 prompt，并替换占位符：

请用 rabetbase 帮我检查并增量同步数据库结构变更。

应用 App Code：<APP_CODE>
数据库连接：<连接名称或 dbLinkId>
变更范围：<不确定 / 表1、表2>
变更说明：<新增字段 / 修改字段 / 新增表 / 修改关联>

请先确认连接和分析状态。
如果不确定变更范围，先检查库表差异，并告诉我建议分析哪些表。
只对变更表做增量分析，不要直接全量分析。
最后告诉我分析状态、planId、需要检查的数据集和页面。

检查结果

• [ ] 增量分析任务状态为 成功 或 部分成功。

• [ ] 变更表可以在 数据集总览 中找到。

• [ ] 新增或修改的字段已经出现在数据集里。

• [ ] 业务数据模型 中的关联关系符合预期。

• [ ] 依赖这些数据集的页面展示正常。

常见问题

现象	处理方式
找不到增量分析入口	确认数据库已经完成过第一次分析，并且连接状态正常。
不知道该勾选哪些表	让 Agent 先检查库表差异，再按差异结果发起增量分析。
分析任务失败	打开分析结果，检查表权限、字段类型、网络连接和超大表情况。
新字段已经分析，但页面没变	进入页面配置，确认页面使用的数据集字段已更新并重新发布。
关联关系不正确	进入业务数据模型检查关联字段，必要时重新分析相关上下游表。

相关文档

• 连接数据库并完成首次分析
• 理解逆向结果与业务模型
• 页面研发、配置菜单与发布

了解 Rabetbase CLI：Rabetbase CLI - Vibe Coding研发套件