数据库
供人、智能体和脚本读写的结构化内容库。
Database 是什么、不是什么
Database 是 headless CMS 式的内容库:人、智能体和脚本通过公开 API 直接读写结构化的表与行。它保存行程、目录等内容,独立于使用这些内容的应用。它不是应用的私有运行库,也不是数据仓库。
| 角色 | 谁用 | 生命周期 | 存在哪里 |
|---|---|---|---|
| 内容库 | 人、智能体、脚本;应用也可通过公开 API 读取 | 内容独立于应用发布进行编辑和复用 | 结构化内容用 Database,文件用 File,可检索知识用 Knowledge |
| 应用运行库 | 管理订单、会话和业务规则的应用代码 | 状态随应用运行而变化,由应用自己的业务约束管理 | 应用自带的 d1、kv 或 r2 components |
| 数据仓库 | 分析人员和报表流水线 | 积累历史数据用于分析 | 专门的分析型数据仓库,不使用 Database |
典型模式是内容库 → 构建 → 发布到应用:从 Database 读取行程内容,构建站点文件,再用 praxis.application.publish 上传、创建版本并部署。修改源内容不会更新这些已发布的文件;需要再次构建和发布才能包含修改。
每个库是一个隔离单元,包含自己的表、字段、行和事件。
通过 Database API 创建库与表结构;通过官方 supabase-js 读写行。同一库的两个行访问地址共享数据。