ツール
Prisma Postgres のデータは、Prisma Studio またはサードパーティのデータベースエディタを使用して表示および編集できます。
Prisma Studio でデータを表示および編集する
Prisma Postgres では、Prisma Studio のホスト版がプロジェクトで利用できます。プロジェクト環境で、左側のナビゲーションでStudioタブを選択してデータを表示および編集します
ローカルでPrisma Studioを実行することもできます。
npx prisma studio
これにより、http://localhost:5555 でライブサーバーが起動し、データベースにアクセスして操作できます。
サードパーティのデータベースエディタでPrisma Postgresインスタンスに接続する
Prisma Postgres インスタンスには、pgAdmin、TablePlus、Postico などのサードパーティのデータベースエディタを使用して、@prisma/ppg-tunnel パッケージ を使って接続できます。TablePlus を使って接続する例を以下に示します。
1. Prisma Postgresに直接アクセスするためのTCPトンネルを作成する
現在のディレクトリにDATABASE_URLが設定された.envファイルが既にある場合、トンネルCLIは自動的にそれを取得するため、手動でエクスポートする必要はありません。ただし、.envファイルを設定していない場合は、DATABASE_URL環境変数を明示的に設定する必要があります。
ターミナルで、接続したいPrisma Postgresインスタンスを参照する環境変数DATABASE_URLを設定します（API_KEYプレースホルダーをPrisma PostgresインスタンスのAPIキー値に置き換えてください）。
- macOS
- Linux
- Windows
export DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key=API_KEY"
export DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key=API_KEY"
set DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key=API_KEY"
ターミナルでDATABASE_URLを明示的に設定した場合、その値が.envファイルの値よりも優先されます。
@prisma/ppg-tunnelパッケージを介してPrisma Postgresインスタンスに接続するには、以下のコマンドを実行します。
npx @prisma/ppg-tunnel --host 127.0.0.1 --port 52604
Prisma Postgres auth proxy listening on 127.0.0.1:52604 🚀
Your connection is authenticated using your Prisma Postgres API key.
...
==============================
hostname: 127.0.0.1
port: 52604
username: <anything>
password: <none>
==============================
上記出力からポートをコピーしてください。次のステップで必要になります。
データベースエディタを使用している間は、接続を維持するためにこのトンネルプロセスを実行したままにしてください。
2a. TablePlusを使用してPrisma Postgresに接続する
使用しているデータベースエディタに基づいて、@prisma/ppg-tunnelパッケージの出力から得られた詳細情報を使用してPrisma Postgresインスタンスに接続できます。TablePlusに接続文字列を追加するには、
- TablePlusを開き、+アイコンをクリックして新しい接続を追加します。
- データベースタイプとしてPostgreSQLを選択します。
- 以下の詳細を入力してください
- 名前: 接続に付けたい任意の名前。
- ホスト: この場合は
127.0.0.1。 - ポート:
@prisma/ppg-tunnelパッケージの出力から取得したポート番号。 - ユーザー: トンネル経由のため無視されます。任意の値を提供できます。
- パスワード: トンネル経由のため無視されます。任意の値を提供できます。
- 接続をクリックして、Prisma Postgresインスタンスに接続します。
2b. DataGripを使用してPrisma Postgresに接続する
使用しているデータベースエディタに基づいて、@prisma/ppg-tunnelパッケージの出力から得られた詳細情報を使用してPrisma Postgresインスタンスに接続できます。DataGripに接続文字列を追加するには、
- DataGripを開き、+アイコンをクリックして「データソース」を選択します。
- データベースタイプとしてPostgreSQLを選択します。
- 以下の詳細を入力してください
- 名前: 接続に付けたい任意の名前。
- ホスト: この場合は
127.0.0.1。 - ポート:
@prisma/ppg-tunnelパッケージの出力から取得したポート番号。 - ユーザー: トンネル経由のため無視されます。このフィールドは空のままで構いません。
- パスワード: トンネル経由のため無視されます。このフィールドは空のままで構いません。
- URL: URLの末尾に
?sslmode=disableというクエリパラメータを追加します。
- 接続テストをクリックして、DataGripがPrisma Postgresインスタンスに接続できることを確認します。成功したら、OKをクリックして接続を保存します。
2c. DBeaver を使用して Prisma Postgres に接続する
使用しているデータベースエディタに基づいて、@prisma/ppg-tunnelパッケージの出力から得られた詳細情報を使用してPrisma Postgresインスタンスに接続できます。DBeaverに接続文字列を追加するには、
- DBeaver を開き、新しいデータベース接続ボタンをクリックするか、ファイル > 新規を選択して新しい接続を追加します。
- データベースタイプとしてPostgreSQLを選択します。
- 「接続方法」セクションでURLオプションを選択します。
- 以下の形式でURLを入力してください
- URL: あなたのURLは
jdbc:postgresql://localhost:52604/postgres?sslmode=disableの形式である必要があります。ここで、@prisma/ppg-tunnelパッケージの出力から取得したポート番号を必ず入力してください。この場合、ポート番号は52604です。認証はトンネルによって管理されるため、ユーザー名やパスワードを入力する必要はありません。
- URL: あなたのURLは
- 接続テストをクリックして、DBeaverがPrisma Postgresインスタンスに接続できることを確認します。成功したら、完了をクリックします。
2d. Postico を使用して Prisma Postgres に接続する
使用しているデータベースエディタに基づいて、@prisma/ppg-tunnelパッケージの出力から得られた詳細情報を使用してPrisma Postgresインスタンスに接続できます。Posticoに接続文字列を追加するには、
- Postico を開き、新しいサーバーボタンをクリックして新しい接続を追加します。
- 以下の詳細を入力してください
- 名前: 接続に付けたい任意の名前。
- ホスト: この場合は
127.0.0.1。 - ポート:
@prisma/ppg-tunnelパッケージの出力から取得したポート番号。 - ユーザー: トンネル経由のため無視されます。このフィールドは空のままで構いません。
- パスワード: トンネル経由のため無視されます。このフィールドは空のままで構いません。
- 「Pre-Connect Shell Script」にチェックを入れ、以下を入力します。
cat <<eof
{
"sslmode":"disable",
}
eof - 接続テストをクリックして、PosticoがPrisma Postgresインスタンスに接続できることを確認します。成功したら、接続をクリックします。
