セットアップと設定

このセクションでは、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は、特定のデータベースでは通常実現できない機能、または拡張機能を必要とする機能を提供します。これらの機能はポリフィルと呼ばれます。すべてのデータベースについて、これには以下が含まれます