设置和配置

本节介绍如何设置、生成、配置和实例化 PrismaClient ，以及何时以及如何主动启动 管理连接。

¥This section describes how to set up, generate, configure, and instantiate PrismaClient , as well as when and how to actively manage connections.

在这个部分

¥In this section

介绍

Prisma Client 是一个自动生成且类型安全的查询构建器，专为你的数据量身定制。开始使用 Prisma 客户端的最简单方法是遵循 快速开始。

生成 Prisma 客户端

Prisma 客户端是一个生成的数据库客户端，根据你的数据库模式量身定制。默认情况下，Prisma 客户端会生成到 node_modules/.prisma/client 文件夹中，但我们强烈建议使用 你指定输出位置。

实例化 Prisma 客户端

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

数据库连接

自定义模型和字段名称

Prisma 客户端 API 是根据 Prisma 架构 中的模型生成的。模型通常是数据库表的 1:1 映射。

配置错误格式

默认情况下，Prisma 客户端使用 ANSI 转义字符 来漂亮地打印错误堆栈并提供有关如何解决问题的建议。虽然这在从终端使用 Prisma Client 时非常有用，但在 GraphQL API 等上下文中，你只需要最小的错误而不需要任何额外的格式。

读取副本

只读副本使你能够跨数据库副本分配工作负载，以应对高流量工作负载。读取副本扩展、@prisma/extension-read-replicas 向 Prisma 客户端添加了对只读数据库副本的支持。

数据库填充

Prisma Client 提供的功能通常无法通过特定数据库实现或需要扩展。这些功能称为 Polyfill。对于所有数据库，这包括：

无 Rust 引擎

从 v6.7.0 开始，你可以在 PostgreSQL、SQLite、D1、PlanetScale 和 MS SQL Server 数据库上使用无需 Rust 引擎 二进制文件的 Prisma ORM。