跳到主要内容

Supabase

本指南讨论了使用 Prisma ORM 和 Supabase 的概念，解释了 Supabase 与其他数据库提供商之间的共性和差异，并引导您完成将应用程序与 Supabase 集成的配置过程。

什么是 Supabase？​

Supabase 是一个 PostgreSQL 托管服务和开源 Firebase 替代方案，提供构建产品所需的所有后端功能。与 Firebase 不同，Supabase 由 PostgreSQL 支持，可以使用 Prisma ORM 直接访问。

要了解有关 Supabase 的更多信息，您可以查看他们的架构 此处 和功能 此处

与其他数据库提供商的共性​

使用 Prisma ORM 与 Supabase 的许多方面与使用 Prisma ORM 与任何其他关系数据库一样。您仍然可以

具体注意事项​

如果您想使用 Supabase 提供的 连接池功能，您需要使用通过您的 Supabase 数据库设置 可用的连接池连接字符串，在您的 DATABASE_URL 环境变量的末尾附加 ?pgbouncer=true

.env
# Connect to Supabase via connection pooling with Supavisor.
DATABASE_URL="postgres://postgres.[your-supabase-project]:[password]@aws-0-[aws-region].pooler.supabase.com:6543/postgres?pgbouncer=true"

如果您想使用 Prisma CLI 对数据库执行其他操作（例如迁移），则需要添加一个 DIRECT_URL 环境变量以在 datasource.directUrl 属性中使用，以便 CLI 可以绕过 Supavisor

.env
# Connect to Supabase via connection pooling with Supavisor.
DATABASE_URL="postgres://postgres.[your-supabase-project]:[password]@aws-0-[aws-region].pooler.supabase.com:6543/postgres?pgbouncer=true"

# Direct connection to the database. Used for migrations.
DIRECT_URL="postgres://postgres.[your-supabase-project]:[password]@aws-0-[aws-region].pooler.supabase.com:5432/postgres"

然后您可以更新您的 schema.prisma 以使用新的直接 URL

schema.prisma
datasource db {
  provider  = "postgresql"
  url       = env("DATABASE_URL")
  directUrl = env("DIRECT_URL")
}

有关 directUrl 字段的更多信息，请查看 此处。

info

我们强烈建议除了 DIRECT_URL 之外还使用 Supavisor 的连接池。您将获得 Prisma CLI 的出色开发体验，同时还允许连接池化，无论您的部署策略如何。虽然这对每个应用程序来说并不严格必要，但无服务器解决方案不可避免地需要连接池化。

Supabase 入门​

如果您有兴趣了解更多信息，Supabase 有一个很棒的指南，用于将 Supabase 提供的数据库连接到您的 Prisma 项目，可在 此处 获得。

如果您在与 Supabase 集成时遇到问题，请查看这些 具体的故障排除技巧 或 Prisma 的 GitHub 讨论 以获得更多帮助。