无 Rust 引擎

自 v6.7.0 起，你可以在 PostgreSQL、SQLite、D1、PlanetScale 和 MS SQL Server 数据库上使用不带 Rust 引擎二进制文件的 Prisma ORM。

本页概述了如何使用此版本的 Prisma ORM。

不使用 Rust 引擎的 Prisma ORM

如果你在不使用 Rust 引擎的情况下使用 Prisma ORM，主要的技术区别在于：

• 在 generator 块中没有 binaryTargets 和 engineType 字段
• 没有下载到生成 Prisma Client 目录中的查询引擎二进制文件
• 需要使用驱动适配器进行数据库连接管理

用法

先决条件

• Prisma ORM v6.7.0（或更高版本）

1. 设置特性标志

使用新架构需要设置 driverAdapters 和 queryCompiler 特性标志

schema.prisma

generator client {
  provider        = "prisma-client-js" // or `prisma-client`
  previewFeatures = ["queryCompiler", "driverAdapters"]
  output          = "../generated/prisma"
}

2. 重新生成 Prisma Client

为了使特性标志生效，你需要重新生成 Prisma Client

npx prisma generate

3. 安装驱动适配器

根据你使用的数据库，你需要安装不同的驱动适配器库

PostgreSQL

npm install @prisma/adapter-pg

SQLite

npm install @prisma/adapter-better-sqlite3

D1

npm install @prisma/adapter-d1

PlanetScale

npm install @prisma/adapter-planetscale

MSSQL

npm install @prisma/adapter-mssql

4. 实例化 Prisma Client

最后，你需要实例化 Prisma Client，你可以使用驱动适配器和正在使用的数据库实例的连接 URL 来完成此操作。

PostgreSQL

import { PrismaPg } from '@prisma/adapter-pg'
import { PrismaClient } from './generated/prisma'

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

SQLite

import { PrismaBetterSQLite3 } from '@prisma/adapter-better-sqlite3';
import { PrismaClient } from './generated/prisma';

const adapter = new PrismaBetterSQLite3({ url: process.env.DATABASE_URL })
const prisma = new PrismaClient({ adapter });

D1

import { PrismaClient } from '@prisma/client'
import { PrismaD1 } from '@prisma/adapter-d1'

export interface Env {
  DB: D1Database
}

export default {
  async fetch(
    request: Request,
    env: Env,
    ctx: ExecutionContext
  ): Promise<Response> {
    const adapter = new PrismaD1(env.DB)
    const prisma = new PrismaClient({ adapter })

    // ... query your DB
  },
}

PlanetScale

import { PrismaPlanetScale } from '@prisma/adapter-planetscale'
import { PrismaClient } from '@prisma/client'
import { fetch as undiciFetch } from 'undici'

const adapter = new PrismaPlanetScale({ url: process.env.DATABASE_URL, fetch: undiciFetch })
const prisma = new PrismaClient({ adapter })

MSSQL

import { PrismaMSSQL } from '@prisma/adapter-mssql';
import { PrismaClient } from './generated/prisma';

const sqlConfig = {
  user: process.env.DB_USER,
  password: process.env.DB_PASSWORD,
  database: process.env.DB_NAME,
  server: process.env.HOST,
  pool: {
    max: 10,
    min: 0,
    idleTimeoutMillis: 30000
  },
  options: {
    encrypt: true, // for azure
    trustServerCertificate: false // change to true for local dev / self-signed certs
  }
}

const adapter = new PrismaMSSQL(sqlConfig)
const prisma = new PrismaClient({ adapter });

5. 查询数据库

如果你完成了前面的步骤，就可以像往常使用 Prisma Client 一样查询你的数据库了。无需其他更改。