设置与配置

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

在本节中

简介

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

生成 Prisma 客户端

Prisma Client 是一个生成的数据库客户端，专为您的数据库 schema 量身定制。默认情况下，Prisma Client 生成到 node_modules/.prisma/client 文件夹中，但我们强烈建议您指定一个输出位置。

实例化 Prisma 客户端

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

数据库连接

自定义模型和字段名称

Prisma Client API 是根据您的 Prisma schema 中的模型生成的。模型通常是您的数据库表的 1:1 映射。

配置错误格式

默认情况下，Prisma Client 使用 ANSI 转义字符来美化打印错误堆栈并提供解决问题的建议。虽然这在从终端使用 Prisma Client 时非常有用，但在像 GraphQL API 这样的上下文中，您只需要最少的错误信息，而无需任何额外的格式化。

读取副本

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

数据库 Polyfill

Prisma Client 提供了一些功能，这些功能通常是特定数据库无法实现或需要扩展才能实现。这些功能被称为 polyfills。对于所有数据库，这包括

无 Rust 引擎

自 v6.16.0 起，在 PostgreSQL、CockroachDB、Neon、MySQL、PlanetScale、SQLite、D1 和 MS SQL Server 数据库上使用不带 Rust 引擎二进制文件的 Prisma ORM 已普遍可用。