跳到主要内容

读取副本

读取副本使您能够跨数据库副本分发工作负载,以应对高流量工作负载。读取副本扩展 read replicas extension `@prisma/extension-read-replicas` 为 Prisma Client 添加了对只读数据库副本的支持。

读取副本扩展支持 Prisma ORM 5.2.0 及更高版本。如果您遇到错误或有反馈,请在此处创建 GitHub issue here

设置读取副本扩展

安装扩展

npm install @prisma/extension-read-replicas

通过扩展您的 Prisma Client 实例来初始化扩展,并在扩展的 url 选项中为扩展提供指向您的读取副本的连接字符串。

import { PrismaClient } from '@prisma/client'
import { readReplicas } from '@prisma/extension-read-replicas'

const prisma = new PrismaClient().$extends(
readReplicas({
url: process.env.DATABASE_URL_REPLICA,
})
)

// Query is run against the database replica
await prisma.post.findMany()

// Query is run against the primary database
await prisma.post.create({
data: {/** */},
})

所有读取操作,例如 findMany,都将根据上述设置对数据库副本执行。所有写入操作 — 例如 createupdate — 和 $transaction 查询,都将对您的主数据库执行。

如果您遇到错误或有反馈,请在此处创建 GitHub issue here

配置多个数据库副本

url 属性也接受值数组,即您要配置的所有数据库副本的数组

const prisma = new PrismaClient().$extends(
readReplicas({
url: [
process.env.DATABASE_URL_REPLICA_1,
process.env.DATABASE_URL_REPLICA_2,
],
})
)

如果您配置了多个读取副本,将随机选择一个数据库副本以执行您的查询。

对主数据库执行读取操作

您可以使用 $primary() 方法显式地对主数据库执行读取操作

const posts = await prisma.$primary().post.findMany()

对数据库副本执行操作

您可以使用 $replica() 方法显式地对副本而不是主数据库执行查询

const result = await prisma.$replica().user.findFirst(...)