Atoms 云数据库用于存储和管理你的应用所依赖的结构化数据，包括产品、预订、订单、表单提交内容以及用户生成内容。在数据库模块中，你可以查看环境和数据表，搜索和编辑记录，检查表结构，并使用 CSV 文件导入或导出数据。

本指南介绍内置于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可复制当前显示的结构。

添加、编辑或删除行

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

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

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

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

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

创建数据表或更改结构

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

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

只有workspace owner可以创建数据表或更改数据表结构。

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

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

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

导入或导出 CSV 数据

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

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

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

权限和受保护的数据表

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

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

修复常见数据库问题

“No databases found” 或 “No tables found”

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

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

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

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

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

无法导入 CSV 文件

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

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

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

常见问题

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

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

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

需要提供的信息：

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

请携带这些详细信息联系支持，以便我们在进行更改前比较 Development/Production 版本、迁移状态和结构差异。

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

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

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

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

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

3. 你是否已经有备份？

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

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