管理数据、导入导出与渠道

数据库详情页把记录分为测试数据和线上数据。两套数据使用相同表结构，但存储环境相互隔离；测试记录不会自动复制到线上，线上记录也不会自动出现在测试页签。

测试数据

测试数据用于调试表结构、工作流节点、应用交互和权限规则。

图 1：测试数据页提供增行、批量导入、数据导出、清空、刷新、搜索和渠道筛选。清空测试数据不可恢复，操作前仍应导出备份。

建议至少准备：

• 一条字段完整的正常记录。
• 必填字段缺失、类型错误和超长文本样本。
• 数字上下界、布尔值和不同时区的时间样本。
• 两个最终用户分别创建的记录。
• 两个渠道分别创建的记录。
• 用于验证重复提交、幂等更新和空查询结果的记录。

同一工作空间中的资源如果引用同一个资源库数据库，并使用相同测试环境、用户和渠道范围，可以访问对应测试记录。应用内创建的数据表仍属于应用自己的作用域，不要与资源库数据库混淆。

线上数据

线上数据是应用、智能体、工作流、API 或 SDK 在正式运行渠道中产生的数据。

图 2：线上数据页会提示这是正式运行数据。页面保留增行、导入、导出、刷新、筛选和行级操作，但不提供测试页的一键清空按钮。

操作线上数据前：

1. 确认当前页签为 线上数据，并核对数据库名称。
2. 通过关键词和渠道筛选缩小范围。
3. 记录原值、记录 id、用户、渠道和业务单号。
4. 修改或删除前导出目标记录；批量操作还需保留完整备份。
5. 完成后从实际调用渠道验证结果，并检查产生异常数据的上游流程。

不建议把线上表格当作日常人工修数工具。反复出现错误记录时，应修复工作流、应用或接口中的真实原因。

增加、编辑与删除记录

点击 增加行 后，只填写自定义字段；id、sys_platform、uuid、created_at 由系统根据当前环境、渠道和用户上下文生成。

操作	检查项
新增	必填字段、数据类型、枚举、业务唯一性、渠道和用户
编辑	原值、并发写入、工作流是否正在更新同一记录
删除	条件范围、引用关系、备份和是否可用软删除替代

需要保留审计轨迹时，优先增加 status、deleted_at、updated_by 等业务字段，通过状态停用记录，而不是直接物理删除。

批量导入

当前页面支持 JSON 和 CSV，提示文件大小控制在 20MB 以内。点击 批量导入 时先选择数据渠道，然后进入四步流程：

1. 上传：上传文件，或下载当前表结构对应的 CSV 模板。
2. 表结构配置：确认文件列与自定义字段的匹配关系。
3. 预览：检查解析后的值、空值和类型转换结果。
4. 数据处理：确认后写入当前测试或线上环境。

文件要求

• CSV 使用 UTF-8 编码，首行字段名与当前自定义字段一致。
• JSON 使用页面模板要求的记录数组结构。
• 不导入 id、sys_platform、uuid、created_at 等系统字段。
• Integer、Number、Boolean、Time 使用可被当前页面解析的值。
• 必填字段不能缺失；可选字段需要明确空值处理。
• 文件中不得包含公式注入内容、脚本、密码、Token 或无业务必要的个人信息。

先用少量记录在测试环境完成相同文件的导入。正式导入后核对成功数、失败信息、首行、末行和随机样本，不把“文件解析成功”当作“全部写入正确”。

数据导出与备份

数据导出生成 CSV：勾选记录时导出选中行，未选择时导出当前环境下的数据。筛选仅用于缩小页面观察范围时，导出前仍要确认实际导出范围。

导出文件是业务数据副本，应遵循原数据的权限和保留规则：

• 文件名中标明数据库、环境和导出时间。
• 保存到受控位置，不上传公共网盘或群聊。
• 含个人信息时限制接收人，并在使用后按期限清理。
• 重要变更前同时备份测试和线上数据，并验证文件能被正确打开和解析。

渠道读写配置

渠道读写配置决定每个调用渠道对当前数据库执行增、删、改、查时，操作测试数据还是线上数据。

图 3：渠道列表由当前环境可用的发布能力动态生成。每个渠道可单独选择测试数据或线上数据，保存后影响该渠道后续请求。

典型配置方式：

阶段	渠道目标	验证重点
开发调试	测试数据	字段映射、节点逻辑、异常输入
业务验收	测试数据	多用户、跨渠道、幂等和权限边界
正式发布	线上数据	正式身份、监控、备份和回滚方案

保存前确认线上表结构与测试时一致，调用方能正确传递用户和渠道身份，写入操作具备参数校验和重复提交保护。不要在不清楚调用关系时把所有渠道一次性切换到线上。

渠道读写与渠道共享的区别

配置	控制内容
渠道读写配置	某个渠道读写测试环境还是线上环境
渠道共享模式	在同一数据环境内，不同渠道是否可以访问同一批记录

两者需要同时满足。例如 API 被配置为读取线上数据，但数据库采用渠道隔离时，API 仍只能看到线上环境中属于 API 渠道的记录。

高风险操作

• 清空测试数据：会删除当前测试环境记录，页面明确提示不可恢复。
• 线上导入：可能批量写入正式业务数据，必须先在测试环境使用同一文件验证。
• 批量删除或修正：先导出完整备份，并取得数据负责人的确认。
• 删除数据库：只有资源所有者可以删除；删除后引用该资源的调用方会失去依赖，页面没有回收站时按不可撤销处理。

下一步进入在工作流中使用数据库。