跳至主要内容

连接您的数据库

TypeScript
CockroachDB

要连接您的数据库，您需要将 Prisma 架构中 datasource 块的 url 字段设置为您的数据库 连接 URL

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

请注意，prisma init 创建的默认架构使用 PostgreSQL 作为 provider。对于 CockroachDB，您需要编辑 datasource 块以使用 cockroachdb 提供程序。

prisma/schema.prisma
datasource db {
  provider = "cockroachdb"
  url      = env("DATABASE_URL")
}

url 是 通过环境变量设置，该变量在 .env 中定义。您现在需要调整连接 URL 以指向您自己的数据库。

您的数据库 连接 URL 格式 取决于您使用的数据库。CockroachDB 使用 PostgreSQL 连接 URL 格式，其结构如下（所有大写字母部分是您特定连接详细信息的占位符）

postgresql://USER:PASSWORD@HOST:PORT/DATABASE?PARAMETERS

以下是每个组件的简短说明

  • USER：您的数据库用户的名称
  • PASSWORD：您的数据库用户的密码
  • PORT：您的数据库服务器运行的端口。CockroachDB 的默认值为 26257。
  • DATABASE：数据库的名称
  • PARAMETERS：任何其他连接参数。请参阅 CockroachDB 文档 此处。

对于在 CockroachDB Serverless 或 Cockroach Dedicated 数据库上托管的 CockroachDB Cloud，连接 URL 类似于以下内容

.env
DATABASE_URL="postgresql://<myusername>:<mypassword>@<short-id>.<region>.cockroachlabs.cloud:26257/defaultdb?sslmode=verify-full&sslrootcert=$HOME/.postgresql/root.crt&options=--<mycluster>"

要查找 CockroachDB Cloud 上的连接字符串，请单击数据库集群概述页面上的“连接”按钮，然后选择“连接字符串”选项卡。

对于在 本地托管的 CockroachDB 数据库，连接 URL 类似于以下内容

.env
DATABASE_URL="postgresql://root@localhost:26257?sslmode=disable"

您的连接字符串在从命令行启动 CockroachDB 时显示为欢迎文本的一部分。