跳到主要内容

数据库驱动

默认内置驱动​

Prisma Client 的组件之一是 Query Engine（查询引擎）。Query Engine 负责将 Prisma Client 查询转换为 SQL 语句。它使用内置驱动程序通过 TCP 连接到您的数据库，无需额外设置。

Query flow from the user application to the database with Prisma Client

驱动适配器​

Prisma Client 可以使用 JavaScript 数据库驱动程序和驱动适配器连接到您的数据库并运行查询。适配器充当 Prisma Client 和 JavaScript 数据库驱动程序之间的转换器。

Prisma Client 将使用 Query Engine 将 Prisma Client 查询转换为 SQL，并通过 JavaScript 数据库驱动程序运行生成的 SQL 查询。

Query flow from the user application to the database using Prisma Client and driver adapters

驱动适配器有两种不同的类型

注意：驱动适配器支持使用 Prisma ORM 的应用程序的边缘部署。

数据库驱动适配器​

您可以使用 Prisma Client 中基于 Node.js 的驱动程序，通过数据库驱动适配器连接到您的数据库。Prisma 维护以下数据库驱动适配器

Serverless 驱动适配器​

数据库提供商（如 Neon 和 PlanetScale）允许您使用 TCP 以外的其他协议（如 HTTP 和 WebSockets）连接到您的数据库。这些数据库驱动程序针对在 serverless 和边缘环境中连接到您的数据库进行了优化。

Prisma ORM 维护以下 serverless 驱动适配器

社区维护的数据库驱动适配器​

您还可以为您正在使用的数据库构建自己的驱动适配器。以下是社区维护的驱动适配器列表

如何使用驱动适配器​

要使用此功能

  1. 更新您 schema 中的 previewFeatures 块，以包含 driverAdapters 预览功能

    generator client {
      provider        = "prisma-client-js"
      previewFeatures = ["driverAdapters"]
    }

  2. 生成 Prisma Client

    npx prisma generate

  3. 请参阅以下页面，以了解有关如何将特定驱动适配器与特定数据库提供商结合使用的更多信息

关于使用驱动适配器的注意事项​

驱动适配器不从 Prisma schema 读取连接字符串​

当使用 Prisma ORM 的内置驱动程序时，连接字符串从 Prisma schema 中 datasource 块的 url 字段读取。

另一方面，当使用驱动适配器时，连接字符串需要在您的应用程序代码中提供，在最初设置驱动适配器时。以下是如何为 pg 驱动程序和 @prisma/adapter-pg 适配器完成此操作的

import { PrismaClient } from '@prisma/client'
import { PrismaPg } from '@prisma/adapter-pg'
import { Pool } from 'pg'

const pool = new Pool({ connectionString: env.DATABASE_URL })
const adapter = new PrismaPg(pool)
const prisma = new PrismaClient({ adapter })

有关具体的设置说明，请参阅您正在使用的驱动适配器的文档。

驱动适配器和自定义输出路径​

自 Prisma 5.9.0 起，当使用 driverAdapters 预览功能以及 Prisma Client 的自定义输出路径时，您不能使用相对路径引用 Prisma Client。

假设您在 Prisma schema 中将 output 设置为 ../src/generated/client

generator client {
  provider = "prisma-client-js"
  output   = "../src/generated/client"
}

您不应该做的是相对引用该路径

// what not to do!
import { PrismaClient } from './src/generated/client'

const client = new PrismaClient()

相反，您需要使用链接的依赖项。

npm add db@./src/generated/client

现在，您应该能够使用 db 引用您生成的客户端了！

import { PrismaClient } from 'db'

const client = new PrismaClient()

驱动适配器和特定框架​

Nuxt​

将驱动适配器与 Nuxt 一起使用以部署到边缘函数环境并非开箱即用，但添加 nitro.experimental.wasm 配置选项可以解决此问题

export default defineNuxtConfig({
  // ...
  nitro: {
    // ...
    experimental: {
      wasm: true,
    },
  },
  // ...
})

有关可以部署到 Cloudflare Pages 的完整示例，请参阅此示例项目。