数据库

使用 Postgres 与 Supabase

把应用指向任意 Postgres 数据库(包括 Supabase 与 Neon),并用迁移链构建 schema。

任何 Postgres 数据库都通过通用的 Drizzle Postgres 适配器接入。Supabase 和 Neon 是同一代码路径上的托管 Postgres 端点。应用不使用 Supabase SDK、认证助手、存储 API 或行级安全策略。

准备工作

  • 一个 Postgres 数据库及其连接串,例如 Supabase 的 Project Settings → Database。
  • 一台能连上该数据库、用于执行迁移的机器。
  • 一个空数据库。不是由迁移链创建的 schema 无法原地迁移。

在托管平台创建数据库

厂商适用场景
Supabase直连或会话连接池
Neon按分支获取数据库连接串

连接数据库

设置连接

.env
DATABASE_DIALECT=postgres
DATABASE_URL=postgresql://USER:PASSWORD@HOST:5432/postgres

DATABASE_ADAPTER 可以不设置,默认为 postgres。

构建 schema

pnpm db:migrate

这会应用 drizzle/migrations/postgres 下的 Postgres 迁移链。

创建管理员

SUPER_ADMIN_EMAIL=you@example.com SUPER_ADMIN_PASSWORD='<password>' pnpm db:bootstrap-super-admin

凭据只留在服务端

不要把连接串或 Supabase service-role 密钥暴露给客户端代码。Supabase 的 Data API 若已暴露这些表,需限制角色授权,并对暴露表启用及审查行级安全策略。本项目的服务端权限不会自动保护该 API。

使用托管 Postgres

Supabase 和 Neon 使用同一套 Postgres 适配器与迁移链。迁移优先用直连,运行期使用上文选定的连接方式;应用不需要服务商 SDK。修改 schema 时,Postgres 与 SQLite 两条迁移链都要添加对应迁移。

生产环境里连接从哪里来

部署如何连上 Postgres,取决于 deploy.config.json 里记录的平台。上面的步骤适用于本地使用和在检出目录里迁移;生产环境里连接这样提供:

平台应用如何连接schema 如何迁移
Cloudflare经 Hyperdrive:DATABASE_ADAPTER=hyperdrive,加上 wrangler.jsonc 里的 HYPERDRIVE 绑定。Worker 不持有 DATABASE_URL在检出目录里把 DATABASE_URL 设为 Postgres URL,执行 pnpm db:migrate
Fly.ioDATABASE_URL 作为应用密钥每次部署时的 release_command
Railway.railway/railway.ts 里声明的 Postgres,它的 DATABASE_URL 会传给各个服务web 服务的 pre-deploy 步骤
Dockercompose 自带的 postgres 服务,POSTGRES_PASSWORD 来自 .env.productioncompose 的 migrate 服务

在 Workers 上,Postgres 客户端只存活一个请求,连接池由它背后的 Hyperdrive 负责。见部署到 Cloudflare Workers、部署到 Fly.io、部署到 Railway和用 Docker Compose 部署。

验证

pnpm validate:db-adapters

然后启动应用,以管理员身份登录并打开 /admin。

常见问题

出现 DATABASE_URL is required when DATABASE_ADAPTER=postgres

连接串为空。设置 DATABASE_URL。

pnpm db:migrate 报告已有 schema

数据库中存在不是由迁移链创建的表。删库重建后再运行 pnpm db:migrate。

需要运行 pnpm db:generate 吗?

不需要。generate 用于为 schema 变更写出新迁移,并不用于准备数据库。

参考

下一步