连接 URL

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

连接 URL 通过您的 Prisma schema 中 datasource 块的 url 字段提供。它通常由以下组件组成（SQLite 除外）

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

确保在开始使用 Prisma ORM 时手头有这些信息。如果您还没有运行数据库服务器，您可以选择使用本地 SQLite 数据库文件（请参阅快速入门）或使用 Prisma Postgres 设置免费的 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

• 当它在构建时更新 schema 时
• 当它在运行时连接到数据库时

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