# 数据库 (/docs/cloud/services/database)



## Database 是什么、不是什么 [#database-是什么不是什么]

Database 是 headless CMS 式的内容库：人、智能体和脚本通过公开 API 直接读写结构化的表与行。它保存行程、目录等内容，独立于使用这些内容的应用。它不是应用的私有运行库，也不是数据仓库。

| 角色    | 谁用                       | 生命周期                    | 存在哪里                                      |
| ----- | ------------------------ | ----------------------- | ----------------------------------------- |
| 内容库   | 人、智能体、脚本；应用也可通过公开 API 读取 | 内容独立于应用发布进行编辑和复用        | 结构化内容用 Database，文件用 File，可检索知识用 Knowledge |
| 应用运行库 | 管理订单、会话和业务规则的应用代码        | 状态随应用运行而变化，由应用自己的业务约束管理 | 应用自带的 `d1`、`kv` 或 `r2` components         |
| 数据仓库  | 分析人员和报表流水线               | 积累历史数据用于分析              | 专门的分析型数据仓库，不使用 Database                   |

典型模式是**内容库 → 构建 → 发布到应用**：从 Database 读取行程内容，构建站点文件，再用 [`praxis.application.publish`](/docs/cloud/services/application) 上传、创建版本并部署。修改源内容不会更新这些已发布的文件；需要再次构建和发布才能包含修改。

每个库是一个隔离单元，包含自己的表、字段、行和事件。

通过 Database API 创建库与表结构；通过官方 supabase-js 读写行。同一库的两个行访问地址共享数据。

* [快速开始](/docs/cloud/services/database/quickstart)：建库、建表，再读写第一行。
* [概念](/docs/cloud/services/database/concepts)：字段类型、关联、版本与恢复。
* [限制与错误](/docs/cloud/services/database/limits-and-errors)：容量和查询边界。

[API 参考 →](/docs/api/native/database) · [Supabase 兼容接口 →](/docs/api/compatible/supabase) · [Cookbook →](/docs/cookbook)