一般
概要
Prisma Data Platform（PDP）製品を使用するプロジェクトの管理と設定、およびアプリケーションへの統合を可能にするConsole
- Accelerate：スケーラブルな接続プーリングを備えたグローバルデータベースキャッシュでクエリを高速化します。
- Optimize：データベースクエリを高速化するのに役立つ推奨事項を提供します。
- Prisma Postgres：Prisma ORM用に最適化されたマネージドPostgreSQLデータベース。
概念
Consoleのワークフローは、4つの主要な概念に基づいています。
- ユーザーアカウント：PDP製品を使用するには、PDPユーザーアカウントが必要です。ユーザーは通常、すべてワークスペース、プロジェクト、および環境を管理するために1つのユーザーアカウントを作成します。ユーザーは、ワークスペース内のプロジェクトで共同作業するために他のワークスペースに招待されることもあります。
- ワークスペース：ユーザーアカウントは、複数のワークスペースに属することができます。ワークスペースは通常、1つまたは複数のプロジェクトで共同作業する個人のチームを表します。請求はワークスペースレベルで行われます。つまり、月末のワークスペースの請求書は、特定のワークスペース内のプロジェクトに関連するすべての費用を把握します。
- プロジェクト：プロジェクトはワークスペースに属します。通常、チームが取り組んでいるアプリケーションまたはサービスを表します。
- 環境：環境はプロジェクトに属します。通常、
Development、Staging、またはProductionのような開発段階に対応します。APIキーは環境レベルでプロビジョニングされます。また、製品も環境ごとに構成されます（例：Accelerateで使用されるデータベース接続文字列）。
これらの概念が互いにどのように関連しているかの視覚的な図を次に示します。
ユーザーアカウント
ユーザーアカウントは、PDP製品とのインタラクションの前提条件です。これを使用して、ワークスペース（およびそのプロジェクト）を管理できます。ユーザーアカウントは、他のユーザーが作成したワークスペースでの共同作業に招待されることもあります。
ユーザーアカウントを削除する必要がある場合は、こちらにアクセスしてください。
ワークスペース
複数のワークスペースを作成できます。ワークスペースは、プロジェクトをホストするための隔離されたスペースです。ワークスペースには複数のユーザーアカウントを関連付けることができるため、複数のユーザーがワークスペース内のプロジェクトで共同作業できます。
各ワークスペースでは、次のことができます。
- そのワークスペース内のすべてのプロジェクト（およびその環境）を表示および管理します。
- 請求を管理します。つまり、サブスクリプションプランを選択し、支払い方法を設定するか、請求履歴を表示します。
- ワークスペース内のすべてのプロジェクトにわたる、有効にされたPDP製品の使用状況を表示します。
- 他のユーザーをワークスペースでの共同作業に招待します。
- にアクセスしてクエリのパフォーマンスを測定し、AIを活用した推奨事項を受け取ります。
Optimize
Optimizeには、ワークスペース内からアクセスできます。
Optimizeダッシュボードへのアクセス
目的のワークスペースでOptimizeダッシュボードにアクセスするには
- 左側のナビゲーションにあるOptimizeタブをクリックします。
- Optimizeを起動ボタンをクリックします。
Optimize APIキーの生成
Optimize APIキーを取得するには
- Optimizeを使用するワークスペースに移動します。
- Optimizeが起動されていることを確認します。起動されていない場合は、Optimizeを起動ボタンをクリックします。
- Optimizeで、ナビゲーションバーの右上隅にあるプロフィール名をクリックします。
- 設定を選択します。
- APIキーを作成をクリックします。
- 名前フィールドにAPIキーの名前を入力し、作成をクリックします。
- APIキーをコピーして安全に保管します。これは、プロジェクトの
.envファイルで"OPTIMIZE_API_KEY"を介して使用されます。最後に、「安全に保管しました」ボタンをクリックします。
これでOptimize APIキーができました。
プロジェクト
各ワークスペースでは、複数のプロジェクトを作成できます。プロジェクトは通常、アプリケーション（製品またはサービス）を表します。通常、プロジェクトごとに1つのPrismaスキーマがあります。
各プロジェクトでは、次のことができます。
- そのプロジェクト内のすべての環境を表示および管理します。
ワークスペースで作成できるプロジェクトの数は、そのワークスペースで設定されているサブスクリプションプランによって異なります。
環境
環境は、特定のプロジェクトのPDP製品をプロビジョニングするために使用される隔離されたスペースです。環境は通常、Development、Staging、またはProductionなどの開発段階に対応します。すべての新しいプロジェクトは、Productionという名前のデフォルト環境から始まります。デフォルト環境は、プロジェクトに常に少なくとも1つのアクティブな環境があることを保証します。別の環境がデフォルトとして指定されない限り、削除することはできません。
各環境では、次のことができます。
- PDP製品（Optimize、Accelerateなど）を有効、無効化、および構成します。
- APIキーを生成します。
- Accelerateの場合
- データベース接続文字列を設定します。
- Accelerateの接続プールが実行されているリージョンを構成します。
- 接続プールのサイズを変更します。
- クエリの実行時間とクエリ応答サイズの制限を構成します。
- 静的IPを有効にします。
プロジェクトで作成できる環境の数は、ワークスペースで構成されているサブスクリプションプランによって異なります。
データベース接続管理
プロジェクト環境の左側のパネルにあるデータベースタブを使用すると、リモートデータベースへの接続を構成および管理できます。このタブ内の接続セクションには、次の列を含むテーブルが表示されます。
| 列名 | 説明 |
|---|---|
| ヒント | 使用中のデータベースのURL構造を提供します。 |
| 静的IP | データベースおよび関連製品で静的IPが有効になっているかどうかを示します。 |
| 製品 | データベースURLを使用して有効になっている製品を一覧表示します。 |
| アクション | すべてのアクティブな製品を無効にして、接続を削除できます。 |
請求
ワークスペースで選択したサブスクリプションプランによって、そのワークスペースで作成できるプロジェクトと環境の数が決まります。
| スターター | プロ | ビジネス | エンタープライズ | |
|---|---|---|---|---|
| プロジェクト | 5 | 60 | 180 | カスタム |
| 環境 | プロジェクトあたり2 | プロジェクトあたり6 | プロジェクトあたり12 | カスタム |
| データベース | 10 | 60 | 180 | カスタム |
ワークスペースごとの請求
請求はワークスペースごとに設定されます。
- サブスクリプションプランはワークスペースごとに選択されます。つまり、ユーザーアカウントは複数のワークスペースに属することができ、各ワークスペースは異なるプランを使用します。
- 支払い方法はワークスペースごとに選択されます。つまり、ユーザーアカウントは複数のワークスペースに属することができ、各ワークスペースは異なる支払い方法を持ちます。
請求期間の終わりに、選択した支払い方法で、そのワークスペース内のすべてのプロジェクト（およびその環境）にわたる製品の発生費用が請求されます。
ワークスペースの請求セクションで、すべての請求の詳細を設定できます。
日割り計算による請求
すべての基本プランの価格は日割り計算されます。つまり、特定のプランのサブスクリプション期間に対してのみ請求されます。さらに、サブスクリプション中に発生した使用料も請求されます。
例：
- 月の15日にProプランに登録した場合、その月の残りの日数に対する基本プランの価格のみが請求されます。
- 30日間の月の10日後にサブスクリプションプランをダウングレードした場合（例：BusinessからProへ）、Businessプランの基本価格の10日間とProプランの基本価格の20日間が請求されます。
詳細については、価格ページをご覧ください。
サブスクリプションプランのダウングレード
サブスクリプションプランをダウングレードする場合、新しく選択したプランの制限に準拠するために、プロジェクトや環境の一部を削除する必要がある場合があります。
たとえば、ワークスペースがBusinessプランであり、現在14個（15個中）のプロジェクトがある場合、Proプランのプロジェクト制限に準拠するには、少なくとも4つのプロジェクトを削除する必要があります。さらに、残りのプロジェクトがProプランの環境制限に準拠するために、プロジェクトあたり6つ以下の環境しかないことを確認する必要があります。
静的IPなど、ProまたはBusinessプラン専用の機能も無効にする必要があります。静的IPの無効化を含むこれらの調整が完了したら、サブスクリプションプランのダウングレードに進むことができます。
Platform CLIを介したプログラムによるアクセス
Consoleのウェブインターフェースに加えて、Prisma CLIは、PDPアカウントと対話し、PDP製品を管理する別の方法を提供します。
これは、CIワークフローに統合するなど、プログラムによるアクセスが必要な場合に役立ちます。
Prisma CLIの詳細をご覧ください。
APIキー
APIキーは、Prisma ClientからPrisma AccelerateやPrisma Optimizeなどの製品へのリクエストを認証するために必要です。
環境ごとに複数のAPIキーを生成し、環境内のAPIキーセクションから管理できます。