跳到主要内容

实例化 Prisma Client

以下示例演示了如何从默认路径导入和实例化您生成的客户端

import { PrismaClient } from '@prisma/client'

const prisma = new PrismaClient()
提示

您可以进一步使用 构造函数参数 自定义 PrismaClient —— 例如,设置 日志记录级别事务选项 或自定义 错误格式

PrismaClient 实例的数量很重要

您的应用程序通常应该只创建一个 PrismaClient 实例。如何实现这一点取决于您是在长时间运行的应用程序还是在无服务器环境中使用 Prisma ORM。

这样做的原因是,每个 PrismaClient 实例都管理一个连接池,这意味着大量客户端可能会耗尽数据库连接限制。这适用于所有数据库连接器。

如果您使用 MongoDB 连接器,则连接由 MongoDB 驱动程序连接池管理。如果您使用关系数据库连接器,则连接由 Prisma ORM 的 连接池 管理。每个 PrismaClient 实例都会创建自己的池。

  1. 每个客户端都会创建自己的查询引擎实例。

  2. 每个查询引擎都会创建一个 连接池,默认池大小为

  3. 过多的连接可能会开始减慢您的数据库速度,并最终导致如下错误:

    Error in connector: Error querying the database: db error: FATAL: sorry, too many clients already
    at PrismaClientFetcher.request