跳至主要内容

Supabase

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

什么是 Supabase？​

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

要详细了解 Supabase，您可以查看其架构 此处 和功能 此处

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

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

具体注意事项​

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

.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 字段的更多信息，请参见 此处。

信息

我们强烈建议除了 DIRECT_URL 之外，还与 Supavisor 一起使用连接池。您将获得 Prisma CLI 的出色开发体验，同时还允许连接池化，而不管您的部署策略如何。虽然这并非每个应用程序都严格需要，但无服务器解决方案最终将需要连接池。

Supabase 入门​

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

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