跳转到主要内容
每个数据库都是一个专属的 Postgres 实例,完全隔离,支持弹性伸缩,提供连接池和直连两种方式。告诉 AI 你需要什么,它会自动处理设置和凭证。

创建数据库

告诉 AI 你的应用需要什么。它会先列出现有数据库,如果有合适的活跃数据库就直接复用。只有当你需要隔离或现有数据库都不符合时,它才会创建新的 Postgres 实例。

凭证

数据库凭证通过 vault 管理。
  • 查看凭证 - 返回数据库的当前连接 URI。
  • 重新生成凭证 - 重置数据库密码并创建新的 vault 密钥。在凭证丢失、泄露或需要轮换时使用。旧凭证会立即失效。

在应用中使用凭证

对于 AI 生成的应用,AI 会通过 db 工具将数据库凭证注入到流程组件中。应用代码读取标准环境变量,如 DATABASE_URL 和 DIRECT_DATABASE_URL。 对于手动本地命令,通过 Kazzle CLI 运行,指定正确的集合和环境:
不要在前端代码或 VITE_* 变量中放入数据库 URL。

迁移

数据库架构变更放在应用仓库的 SQL 文件中(例如 migrations/001_create_todos.sql)。Kazzle 可以在应用部署流程中运行这些迁移。如果启用了实时同步,AI 也会更新相关的同步设置。

启用实时同步

告诉 AI 在数据库上启用同步。它会等到数据库显示 sync: ready 后再连接实时应用。详见 实时同步。

删除数据库

告诉 AI 删除数据库。Kazzle 会先标记为已删除,在永久清理前可以恢复。

示例:从零开始设置数据库

  1. “创建一个叫 my-app-db 的数据库”
  2. AI 复用合适的数据库或设置 Postgres 并将凭证存储在 vault 中
  3. “创建一个 todos 表,包含 id、text、done 和 created_at 字段”
  4. AI 运行 SQL
  5. “把它连接到我的应用” - AI 将数据库连接到应用的流程组件
对于支持离线功能的实时应用,AI 还会启用同步并设置客户端架构。详见 实时同步 了解完整流程。