连接 URL

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

连接 URL 通过 Prisma 模式中 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

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

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