设置与配置
本节描述如何设置、生成、配置和实例化 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 已普遍可用。