设置与配置
本节介绍如何设置、生成、配置和实例化 PrismaClient
,以及何时以及如何主动管理连接。
本节中
简介
Prisma Client 是一个根据您的数据量身定制的自动生成且类型安全的查询构建器。开始使用 Prisma Client 最简单的方法是遵循快速入门指南。
生成 Prisma Client
Prisma Client 是一个根据您的数据库 Schema 量身定制的生成的数据库客户端。默认情况下,Prisma Client 会生成到 node_modules/.prisma/client 文件夹中,但我们强烈建议您指定一个输出位置。
实例化 Prisma Client
以下示例演示了如何从默认路径导入并实例化您生成的客户端
数据库连接
自定义模型和字段名称
Prisma Client API 是根据您的 Prisma Schema 中的模型生成的。模型通常与您的数据库表是一对一映射。
配置错误格式
默认情况下,Prisma Client 使用 ANSI 转义字符美化打印错误堆栈并提供解决问题的建议。尽管这在从终端使用 Prisma Client 时非常有用,但在 GraphQL API 等上下文中,您可能只希望看到最少的错误信息,而不需要任何额外格式。
读取副本
读取副本使您能够在高流量工作负载下将工作负载分布到数据库副本上。读取副本扩展 @prisma/extension-read-replicas 为 Prisma Client 增加了对只读数据库副本的支持。
数据库 Polyfill
Prisma Client 提供了一些功能,这些功能通常要么无法通过特定数据库实现,要么需要扩展。这些功能被称为 Polyfills。对于所有数据库,这包括
无 Rust 引擎
从 v6.7.0 版本开始,您可以在 PostgreSQL、SQLite、D1、PlanetScale 和 MS SQL Server 数据库上使用不带 Rust 引擎二进制文件的 Prisma ORM。