檢視資料

您可以使用 Prisma Studio 或第三方資料庫編輯器來檢視與編輯 Prisma Postgres 中的資料。

在 Prisma Studio 中檢視與編輯資料

透過 Prisma Postgres，您的專案中已內建託管版本的 Prisma Studio。在您的專案環境中，於，選取左側導覽列中的 Studio 分頁，即可檢視並編輯您的資料。

您也可以透過執行以下指令，在本地端執行 Prisma Studio：

npx prisma studio

這將會在 https://:5555 啟動一個即時伺服器，您可以造訪該網址並與資料庫進行互動。

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

您可以利用 @prisma/ppg-tunnel 套件，透過 pgAdmin、TablePlus、Postico 等第三方資料庫編輯器連線至您的 Prisma Postgres 實例。請參閱下方使用 TablePlus 連線的範例。

1. 建立 TCP 通道以直接存取 Prisma Postgres

如果您的當前目錄中已有設定好 DATABASE_URL 的 .env 檔案，通道 CLI 會自動讀取它，無需手動匯出。不過，如果您尚未設定 .env 檔案，則需要明確設定 DATABASE_URL 環境變數。

在終端機中，設定環境變數 DATABASE_URL 指向您想要連線的 Prisma Postgres 實例（請務必將 API_KEY 預留位置替換為您 Prisma Postgres 實例的 API 金鑰值）：

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

顯示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. 輸入以下詳細資訊：
   • Name（名稱）：您想要給予此連線的任何名稱。
   • Host（主機）：此處為 127.0.0.1。
   • Port（連接埠）：您從 @prisma/ppg-tunnel 套件輸出中取得的 port 號碼。
   • User（使用者）：由於使用了通道，此項將被忽略，您可以輸入任何值。
   • Password（密碼）：由於使用了通道，此項將被忽略，您可以輸入任何值。
4. 點擊 Connect（連線） 以連線至您的 Prisma Postgres 實例。

2b. 使用 DataGrip 連線至 Prisma Postgres

根據您使用的資料庫編輯器，您可以利用從 @prisma/ppg-tunnel 套件輸出中取得的詳細資訊連線至 Prisma Postgres 實例。若要在 DataGrip 中新增連線字串：

1. 開啟 DataGrip，點擊 + 圖示並選擇 "Datasource"。
2. 選擇 PostgreSQL 作為資料庫類型。
3. 輸入以下詳細資訊：
   • Name（名稱）：您想要給予此連線的任何名稱。
   • Host（主機）：此處為 127.0.0.1。
   • Port（連接埠）：您從 @prisma/ppg-tunnel 套件輸出中取得的 port 號碼。
   • User（使用者）：由於使用了通道，此項將被忽略，您可以保持空白。
   • Password（密碼）：由於使用了通道，此項將被忽略，您可以保持空白。
   • URL：在 URL 末尾加上查詢參數 ?sslmode=disable。
4. 點擊 Test Connection（測試連線） 以確保 DataGrip 能連線至您的 Prisma Postgres 實例。連線成功後，點擊 OK 儲存連線。

2c. 使用 DBeaver 連線至 Prisma Postgres

根據您使用的資料庫編輯器，您可以利用從 @prisma/ppg-tunnel 套件輸出中取得的詳細資訊連線至 Prisma Postgres 實例。若要在 DBeaver 中新增連線字串：

1. 開啟 DBeaver 並點擊 New Database Connection（新增資料庫連線） 按鈕，或透過 File（檔案） > New（新增） 來新增連線。
2. 選擇 PostgreSQL 作為資料庫類型。
3. 在連線方式區段選擇 URL 選項。
4. 輸入以下格式的 URL：
   • URL：您的 URL 應採用此格式：jdbc:postgresql://:52604/postgres?sslmode=disable。請務必填入您從 @prisma/ppg-tunnel 套件輸出中取得的連接埠號碼。在此案例中，連接埠號碼為 52604。由於驗證是由通道管理的，因此無需輸入使用者名稱或密碼。
5. 點擊 Test Connection（測試連線） 以確保 DBeaver 能連線至您的 Prisma Postgres 實例。如果成功，點擊 Finish（完成）。

2d. 使用 Postico 連線至 Prisma Postgres

根據您使用的資料庫編輯器，您可以利用從 @prisma/ppg-tunnel 套件輸出中取得的詳細資訊連線至 Prisma Postgres 實例。若要在 Postico 中新增連線字串：

1. 開啟 Postico 並點擊 New Server（新增伺服器） 按鈕以新增連線。
2. 輸入以下詳細資訊：
   • Name（名稱）：您想要給予此連線的任何名稱。
   • Host（主機）：此處為 127.0.0.1。
   • Port（連接埠）：您從 @prisma/ppg-tunnel 套件輸出中取得的 port 號碼。
   • User（使用者）：由於使用了通道，此項將被忽略，您可以保持空白。
   • Password（密碼）：由於使用了通道，此項將被忽略，您可以保持空白。
3. 勾選 "Pre-Connect Shell Script" 並輸入：

   cat <<eof
   {
   "sslmode":"disable",
   }
   eof
4. 點擊 Test Connection（測試連線） 以確保 Postico 能連線至您的 Prisma Postgres 實例。如果成功，點擊 Connect（連線）。