连接 URL

Prisma ORM 需要一个连接 URL 才能连接到您的数据库，例如，当使用 Prisma Client 发送查询或使用 Prisma Migrate 更改数据库模式时。

连接 URL 通过 Prisma 模式中 datasource 块的 url 字段提供。它通常包含以下组件（SQLite 除外）

• 用户：您的数据库用户的名称
• 密码：您的数据库用户的密码
• 主机：运行数据库服务器的机器的 IP 或域名
• 端口：数据库服务器正在运行的端口
• 数据库名称：您要使用的数据库的名称

在开始使用 Prisma ORM 时，请确保您手头有这些信息。如果您还没有运行数据库服务器，您可以使用本地 SQLite 数据库文件（请参阅 快速入门）或 在 Supabase 上设置一个免费的 PostgreSQL 数据库。

格式

连接 URL 的格式取决于您使用的数据库连接器。Prisma ORM 通常支持每个数据库的标准格式。您可以在专用文档页面上了解更多关于数据库连接 URL 的信息

• PostgreSQL
• MySQL
• SQLite
• MongoDB
• Microsoft SQL Server
• CockroachDB

特殊字符

对于 MySQL、PostgreSQL 和 CockroachDB，您必须 对连接 URL 的任何部分（包括密码）中的特殊字符进行百分比编码。例如，p@$$w0rd 变为 p%40%24%24w0rd。

对于 Microsoft SQL Server，您必须 转义连接字符串中任何部分的特殊字符。

示例

以下是 Prisma ORM 支持的数据库连接 URL 示例

PostgreSQL

schema.prisma

datasource db {
  provider = "postgresql"
  url      = "postgresql://janedoe:mypassword@localhost:5432/mydb?schema=sample"
}

MySQL

schema.prisma

datasource db {
  provider = "mysql"
  url      = "mysql://janedoe:mypassword@localhost:3306/mydb"
}

Microsoft SQL Server

schema.prisma

datasource db {
  provider = "sqlserver"
  url      = "sqlserver://127.0.0.1:1433;initial catalog=sample;user=sa;password=mypassword;"
}

SQLite

schema.prisma

datasource db {
  provider = "sqlite"
  url      = "file:./dev.db"
}

CockroachDB

schema.prisma

datasource db {
  provider = "cockroachdb"
  url      = "postgresql://janedoe:mypassword@localhost:26257/mydb?schema=public"
}

MongoDB

schema.prisma

datasource db {
  provider = "mongodb"
  url      = "mongodb+srv://root:<password>@cluster0.ab1cd.mongodb.net/myDatabase?retryWrites=true&w=majority"
}

.env

您也可以将连接 URL 作为环境变量提供

schema.prisma

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

然后，您可以通过在终端中设置环境变量或提供一个名为 .env 的 dotenv 文件来实现。Prisma CLI 将自动获取它。

Prisma ORM 在以下情况下从 dotenv 文件读取连接 URL

• 在构建时更新模式时
• 在运行时连接到数据库时

DATABASE_URL=postgresql://janedoe:mypassword@localhost:5432/mydb