セットアップと設定

このセクションでは、`PrismaClient` のセットアップ、生成、設定、およびインスタンス化の方法、さらに接続を積極的に管理するタイミングと方法について説明します。

このセクションで

はじめに

Prisma Clientは、データに合わせて調整された自動生成された型安全なクエリビルダーです。Prisma Clientを始める最も簡単な方法は、クイックスタートに従うことです。

Prisma Clientの生成

Prisma Clientは、データベーススキーマに合わせて生成されるデータベースクライアントです。デフォルトでは、Prisma Clientはnode_modules/.prisma/clientフォルダーに生成されますが、出力場所を指定することを強くお勧めします。

Prisma Clientのインスタンス化

以下の例は、生成されたクライアントをデフォルトパスからインポートしてインスタンス化する方法を示しています

データベース接続

カスタムモデルとフィールド名

Prisma Client APIは、Prismaスキーマ内のモデルに基づいて生成されます。モデルは通常、データベーステーブルの1:1マッピングです。

エラーフォーマットの設定

デフォルトでは、Prisma ClientはANSIエスケープ文字を使用して、エラーのスタックをきれいに表示し、問題の修正方法に関する推奨事項を提供します。これはPrisma Clientをターミナルから使用する際には非常に便利ですが、GraphQL APIのようなコンテキストでは、追加のフォーマットなしの最小限のエラーのみが必要となります。

リードレプリカ

リードレプリカを使用すると、高トラフィックのワークロードに対して、データベースレプリカ間でワークロードを分散できます。リードレプリカ拡張機能 `@prisma/extension-read-replicas` は、Prisma Clientに読み取り専用データベースレプリカのサポートを追加します。

データベースのポリフィル

Prisma Clientは、特定のデータベースでは通常実現できない、または拡張機能が必要な機能を提供します。これらの機能はポリフィルと呼ばれます。すべてのデータベースにおいて、これには以下が含まれます

Rustエンジンなし

v6.7.0以降、Prisma ORMをPostgreSQL、SQLite、D1、PlanetScale、およびMS SQL ServerデータベースでRustエンジンのバイナリなしで使用できます。