数据库
功能概述
数据库功能为每个项目提供内置的结构化数据管理能力。你可以创建数据表（Collection），定义字段结构（Schema），然后对数据进行增删改查操作。数据库中的数据还可以通过知识库功能进行向量化索引，在工作流中通过 Database Block 进行读写。
界面说明
侧边栏 — 数据表树
顶部操作栏：
- 新建数据表按钮：创建一个新的数据表
- 新建文件夹按钮：创建文件夹来组织数据表
- 首页按钮：取消当前数据表选择
数据表树：
- 以树形结构展示项目中所有的数据表和文件夹
- 支持拖拽排序和嵌套
- 右键可进行重命名、删除操作
- 点击数据表即在右侧加载数据
回收站：
- 点击侧边栏标题旁的回收站图标可查看已删除的数据行
- 支持恢复已删除数据或永久删除
主区域 — 数据管理
未选择表时：显示引导页面，提供创建数据表的入口。
选择表后：
顶部操作栏：
| 功能 | 说明 |
|---|---|
| 表名编辑 | 点击表名可直接重命名 |
| 搜索 | 全文搜索当前表的数据 |
| 管理字段 | 打开 Schema 编辑器，添加、修改或删除字段 |
| 导入 | 支持 JSON / CSV 格式导入数据，可下载模板 |
| 导出 | 将数据导出为 JSON / CSV 格式 |
| 添加数据 | 打开右侧抽屉创建新的数据行 |
数据表格：
- 动态根据 Schema 生成表格列
- 固定列：ID（前 8 位）、创建时间、更新时间、操作
- 每行提供编辑和删除操作
- 支持不同字段类型的格式化展示（布尔值标签、数字千分位、日期格式化、数组/对象预览等）
- 支持分页浏览
数据编辑抽屉：
- 根据 Schema 字段类型渲染对应的输入控件
- 支持的字段类型：string、text、number、boolean、date、relation、array、object
- relation 类型字段可选择关联表中的数据
- 提供必填验证和 JSON 格式验证
操作步骤
创建数据表
- 点击侧边栏的 新建数据表 按钮
- 在文件树中输入表名并确认
- 点击新建的表即可开始管理
定义字段结构
- 选中一个数据表
- 点击顶部操作栏的 管理字段 按钮
- 在弹出的 Schema 编辑器中添加字段
- 为每个字段设置名称、类型和是否必填
- 保存后字段结构生效
- 如有数据影响的变更（重命名、删除、类型变更），系统会弹出确认对话框
添加数据
- 确保数据表已定义至少一个字段
- 点击 添加数据 按钮
- 在右侧抽屉中按字段填写数据
- 点击 创建 保存数据行
编辑和删除数据
- 编辑：点击数据行操作列的编辑图标，在抽屉中修改后保存
- 删除：点击删除图标，确认后数据移入回收站
导入数据
- 先定义好字段结构
- 点击 导入 按钮
- 选择「下载模板」获取 JSON 或 CSV 格式模板
- 按模板格式填入数据
- 再次点击导入并上传文件
导出数据
- 当表中有数据时，点击 导出 按钮
- 选择 JSON 或 CSV 格式
- 文件自动下载到本地
工作流查询分页
Database Block 的 Query 配置提供「页码」和「每页条数」，均可引用上游变量。页码从 1 开始，未配置时为 1；每页默认 20 条、最多 100 条。
例如 105 条数据，每页 10 条时依次查询第 1–11 页，末页返回 5 条；每页 100 条时查询两页即可。通过 hasMore 判断是否继续，并将 nextPage 用作下一次页码。输出保留 rows/total，并增加 page/pageSize/totalPages/hasMore/nextPage。终页或合法越界页 hasMore=false、nextPage=null；空表 total=0/totalPages=0。非法页码、无法解析变量、取消或读取失败会报错，不应当作终页。
过滤条件在取得本页后执行，total 与翻页状态依据整表未删除记录；筛选后空页也可能还有下一页。查询仅作用于当前项目，不接受额外项目 ID。已有 API 仍使用 page/pageSize，OAuth 读取需要既有 project:data:read 和项目访问权限。
每次分页都受现有任务预算约束。条件 Loop 默认迭代上限为 10；105 条、每页 10 条的例子须将上限显式设为至少 11，并核对最后一页。排序以行 ID 确定同时间戳顺序，但没有跨页数据快照；数据并发增删时可能重复或遗漏，读取完整表应在数据稳定时执行，并核对唯一行 ID 数与 total。小页增加请求次数，深页 offset 和精确计数也有性能成本。
相关链接
- 数据库 API 参考 — 完整的 API 接口文档
- Database Block — 在工作流中使用数据库
- 知识库 — 将数据库数据向量化索引