無 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 一樣查詢你的資料庫了。無需其他更改。