工具

你可以使用 Prisma Studio 或第三方資料庫編輯器在 Prisma Postgres 中檢視和編輯你的資料。

在 Prisma Studio 中檢視和編輯資料

藉助 Prisma Postgres，Prisma Studio 的託管版本可在你的專案中為你提供。在你的專案環境中，，在左側導航欄中選擇 Studio 標籤頁，以檢視和編輯你的資料

你也可以透過執行以下命令在本地執行 Prisma Studio：

npx prisma studio

這將在 https://:5555 啟動一個即時伺服器，你可以在其中訪問和與資料庫互動。

使用第三方資料庫編輯器連線到 Prisma Postgres 例項

你可以使用 pgAdmin、TablePlus、Postico 等第三方資料庫編輯器，透過 @prisma/ppg-tunnel 包 連線到你的 Prisma Postgres 例項。請參閱以下示例以瞭解如何使用 TablePlus 進行連線。

1. 建立 TCP 隧道以直接訪問 Prisma Postgres

如果你的當前目錄中已經有一個設定了 DATABASE_URL 的 .env 檔案，隧道 CLI 將自動讀取它，無需手動匯出。但是，如果你尚未設定 .env 檔案，則需要顯式設定 DATABASE_URL 環境變數。

在你的終端中，設定 DATABASE_URL 環境變數以指向你想要連線的 Prisma Postgres 例項（請務必將 API_KEY 佔位符替換為你的 Prisma Postgres 例項的 API 金鑰值）

macOS

export DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key=API_KEY"

Linux

export DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key=API_KEY"

Windows

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

顯示CLI結果

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>
==============================

從上述輸出中複製 port（埠）號，下一步將需要它。

在使用資料庫編輯器時，請保持此隧道程序執行以維持連線。

2a. 使用 TablePlus 連線到 Prisma Postgres

根據你使用的資料庫編輯器，你可以使用從 @prisma/ppg-tunnel 包輸出中獲取的詳細資訊連線到你的 Prisma Postgres 例項。要在 TablePlus 中新增連線字串：

1. 開啟 TablePlus 並點選 + 圖示以新增新連線。
2. 選擇 PostgreSQL 作為資料庫型別。
3. 輸入以下詳細資訊
   • 名稱：你想要為連線指定的任何名稱。
   • 主機：在這種情況下為 127.0.0.1。
   • 埠：從 @prisma/ppg-tunnel 包輸出中獲取的 port（埠）號。
   • 使用者：由於使用隧道，此項將被忽略，你可以在此處提供任何值。
   • 密碼：由於使用隧道，此項將被忽略，你可以在此處提供任何值。
4. 點選 連線 以連線到你的 Prisma Postgres 例項。

2b. 使用 DataGrip 連線到 Prisma Postgres

根據你使用的資料庫編輯器，你可以使用從 @prisma/ppg-tunnel 包輸出中獲取的詳細資訊連線到你的 Prisma Postgres 例項。要在 DataGrip 中新增連線字串：

1. 開啟 DataGrip 並點選 + 圖示，然後選擇“資料來源”。
2. 選擇 PostgreSQL 作為資料庫型別。
3. 輸入以下詳細資訊
   • 名稱：你想要為連線指定的任何名稱。
   • 主機：在這種情況下為 127.0.0.1。
   • 埠：從 @prisma/ppg-tunnel 包輸出中獲取的 port（埠）號。
   • 使用者：由於使用隧道，此項將被忽略，你可以將此欄位留空。
   • 密碼：由於使用隧道，此項將被忽略，你可以將此欄位留空。
   • URL：在 URL 的末尾新增以下查詢引數 ?sslmode=disable。
4. 點選 測試連線 以確保 DataGrip 可以連線到你的 Prisma Postgres 例項。成功後，點選 確定 儲存連線。

2c. 使用 DBeaver 連線到 Prisma Postgres

根據你使用的資料庫編輯器，你可以使用從 @prisma/ppg-tunnel 包輸出中獲取的詳細資訊連線到你的 Prisma Postgres 例項。要在 DBeaver 中新增連線字串：

1. 開啟 DBeaver 並點選 新建資料庫連線 按鈕或 檔案 > 新建 以新增新連線。
2. 選擇 PostgreSQL 作為資料庫型別。
3. 在“連線方式”部分選擇 URL 選項。
4. 按以下格式輸入 URL
   • URL：你的 URL 應該採用以下格式：jdbc:postgresql://:52604/postgres?sslmode=disable。請確保你輸入的是從 @prisma/ppg-tunnel 包輸出中獲得的埠號。在此示例中，埠號為 52604。無需輸入使用者名稱或密碼，因為身份驗證由隧道管理。
5. 點選 測試連線 以確保 DBeaver 可以連線到你的 Prisma Postgres 例項。如果成功，點選 完成。

2d. 使用 Postico 連線到 Prisma Postgres

根據你使用的資料庫編輯器，你可以使用從 @prisma/ppg-tunnel 包輸出中獲取的詳細資訊連線到你的 Prisma Postgres 例項。要在 Postico 中新增連線字串：

1. 開啟 Postico 並點選 新伺服器 按鈕以新增新連線。
2. 輸入以下詳細資訊
   • 名稱：你想要為連線指定的任何名稱。
   • 主機：在這種情況下為 127.0.0.1。
   • 埠：從 @prisma/ppg-tunnel 包輸出中獲取的 port（埠）號。
   • 使用者：由於使用隧道，此項將被忽略，你可以將此欄位留空。
   • 密碼：由於使用隧道，此項將被忽略，你可以將此欄位留空。
3. 勾選“預連線 Shell 指令碼”並輸入

   cat <<eof
   {
   "sslmode":"disable",
   }
   eof
4. 點選 測試連線 以確保 Postico 可以連線到你的 Prisma Postgres 例項。如果成功，點選 連線。