数据库

本指南介绍内置于 Atoms 云 的数据库。如果你的项目使用 Supabase，请改为参阅 Supabase 集成。

打开数据库

在打开数据库之前，请先将你的项目连接到 Atoms 云。如果尚未连接，请按照 Atoms 云 中的连接步骤操作。

1. 在桌面设备上打开你的项目。
2. 在包含 App 预览 的同一工作区工具栏中，选择 Atoms 云。
3. 在 Atoms 云侧边栏中选择 数据库。
4. 在 Databases 下，选择你想查看的数据库。项目可用时，会显示 Development 和 Production 数据库卡片。

每个数据库卡片都会显示已使用的存储空间和可用总量。构建和测试应用时，请使用 Development。在 Production 中进行的更改可能会影响线上应用的数据，因此在进行更改前，请务必确认你当前所在的环境。

选择 Development 或 Production 数据库。

浏览和筛选表数据

1. 根据你要操作的环境，选择 Development 或 Production 数据库卡片。
2. 使用 Search tables 查找数据表，或直接从列表中选择一个。每个数据表卡片都会显示其行数以及是否为只读。
3. 使用 Search rows 在当前数据表中搜索，或选择 Filter 以使用一个或多个字段缩小结果范围。
4. 使用数据表下方的分页箭头控件查看更多行。
5. 若要查看数据表结构，请打开 ••• 菜单并选择 Schema。

Schema 视图会显示每个字段的名称、数据类型、键状态、要求、约束和默认值。选择 Copy 可复制当前显示的 schema。

添加、编辑或删除行

找到你想要修改的数据库后，可以使用以下操作进行更改：

操作	操作方法
添加一行	打开 ... 并选择 Add Row。输入与可用字段匹配的值，然后提交该行。
编辑一行	双击单元格并输入新值。选择 Commit Changes 以保存所有待处理编辑，或选择 Discard 以移除它们。
删除行	选择一行或多行，选择 Delete，然后确认。删除行后无法撤销。

添加一行或确认删除时，更改会立即应用到所选数据库。只有行内单元格编辑需要你选择 Commit Changes 或 Discard。如果你有任何待处理编辑，请先提交或丢弃它们，然后再添加行、导入或导出 CSV 文件、更改搜索或筛选条件，或导航到其他页面。

如果项目位于某个工作区中，只有 Editors 和 workspace owner 可以编辑可写数据表中的行。如果 Atoms 无法检测到某个数据表的主键，你将无法编辑或删除其行，因为 Atoms 无法可靠地识别单条记录。

查看待处理的行编辑，然后提交或丢弃更改。

创建数据表或更改 schema

打开你想更新的数据库环境，然后按照你要执行的更改对应的说明操作：

操作	操作方法
创建数据表	在数据表列表中，点击 ...，然后选择 Create table。输入有效的数据表名称和初始字段，然后提交请求。等待智能体完成后，重新打开 数据库 并验证该数据表。
更改 schema	点击你想修改的数据表，然后点击 ...，并选择 Schema. 使用 Add Field 创建字段，或选择符合条件的字段进行编辑。你可以更改其名称、类型、默认值、必填状态或唯一性。你还可以将非键字段标记为删除。选择 Submit Changes 将请求发送给智能体，或选择 Discard 清除待处理更改。

只有 workspace owner 可以创建数据表或更改数据表的 schema。

提交 schema 请求并不意味着迁移已经完成。请等待智能体完成，在 数据库 中验证结果，并在之后测试你的应用。主键字段和只读数据表无法通过这种方式修改。

在 Add Field 中输入新字段的详细信息。

在选择 Submit Changes 之前查看待处理的 schema 更改。

导入或导出 CSV 数据

选择你要操作的数据表，然后按照相关操作的说明进行：

操作	操作方法
导入 CSV	点击 ... 并选择 Import CSV。选择一个不大于 10 MB 的 .csv 文件，然后在确认前检查文件名、预估行数、所选数据表和环境。CSV 列必须与数据表 schema 匹配。导入的行会立即添加，且无法自动撤销，因此建议先导出现有数据。
导出 CSV	点击 ... 并选择 Export CSV。如果当前启用了搜索或筛选，则只会导出匹配的行。否则，将导出当前数据表中的所有数据。

只有 workspace owner 可以导入或导出 CSV 文件。对于只读数据表，Export CSV 是唯一可用的选项。

权限和受保护的数据表

操作	可执行者	附加要求
添加、编辑或删除行	Editor 或 workspace owner	数据表必须可写。编辑和删除行还需要主键信息。
创建数据表或更改 schema	Workspace owner	主键字段和只读数据表无法修改。
导入或导出 CSV 文件	Workspace owner	不能将 CSV 文件导入只读数据表。

受保护的系统数据表或用户数据表可能会显示 Read-only 标记。你可以查看其数据，并在可用时检查其 schema，但无法从此页面修改其行或结构。

修复常见数据库问题

“No databases found” 或 “No tables found”

请确保 Atoms 云 已连接到项目。如果已经连接，请确认你的应用包含存储持久化数据的功能。如有需要，请让智能体添加基于数据库的功能。智能体完成后，重新打开 数据库 或选择 Refresh。

某个数据库操作缺失或不可用

检查该数据表是否带有 Read-only 标记，然后查看上方权限说明，确认你的工作区角色允许执行该操作。编辑和删除行还需要主键信息。

待处理的行编辑可能会阻止其他操作。在添加行、导入或导出 CSV 文件、更改搜索或筛选条件，或移动到其他页面之前，请先选择 Commit Changes 或 Discard。

如果完成这些检查后该操作仍不可用，请联系 Support，并附上项目或 Chat 链接、环境、数据表、工作区角色、尝试执行的操作以及完整错误文本。

无法导入 CSV 文件

只有 workspace owner 可以导入数据，且目标数据表必须可写。请确保：

• 文件使用 .csv 格式。
• 文件大小不超过 10 MB。
• 其列和数据与目标数据表的 schema 兼容。
• 你已提交或丢弃所有待处理的行编辑。

如果导入仍然失败，请联系 Support，并附上项目或 Chat 链接、环境、目标数据表、工作区角色、文件名和大小、尝试执行的操作以及完整错误文本。

常见问题

我的生产数据库没有同步。我该怎么办？

如果 Development 正常工作，但线上站点（Production）显示缺失的数据表、列或迁移错误：

重要提示：请不要自行重建或覆盖生产数据库。

需要提供的信息：

• Chat 链接和线上 URL
• 完整的 SQL 错误信息
• 缺失的数据表/列名称
• 最近一次数据库 schema 更改
• 最近一个正常工作的线上版本
• 是否必须保留生产数据
• 你是希望完全同步 Development 数据，还是只补齐缺失的结构

请将这些详细信息提供给支持团队，以便我们在进行更改之前比较 Development/Production 版本、迁移状态和 schema 差异。

为什么我的开发数据与生产数据不同？

如果你已经发布了多次，但 Production 仍显示旧数据，而代码更新工作正常：

在联系支持团队之前，请先确认：

1. 当前生产数据是否必须保留？

2. 你是希望用当前 Development 数据完全覆盖，还是只补齐缺失记录？

3. 你是否已经有备份？

4. 你可接受的维护窗口是多久？

在确认数据处理目标之前，我们不会覆盖或重建生产数据。请提供 Development/Production URL，以及显示差异的示例记录 ID 或数量。