Prisma Studio

Prisma Studio 是一個用於編輯資料庫中資料的視覺化工具。請注意，Prisma Studio 不是開源的，但您仍然可以在 prisma/studio 倉庫中建立問題。

在您的終端中執行 npx prisma studio。

模型（表或集合）

當您首次開啟 Prisma Studio 時，您會看到一個數據表佈局，側邊欄顯示了 Prisma schema 檔案中定義的所有模型列表。

資訊

什麼是模型？

術語 模型 指您新增到 Prisma schema 檔案中的資料模型定義。根據您使用的資料庫，模型定義（例如 model User）在關係型資料庫（PostgreSQL、MySQL、SQL Server、SQLite、CockroachDB）中指代表，在 MongoDB 中則指代集合。

欲瞭解更多資訊，請參閱 定義模型。

您可以選擇一個模型，其資料會在新標籤頁中開啟。在此示例中，User 模型被選中。

開啟和關閉模型

要開啟另一個模型，請在側邊欄中找到該模型並點選它。

要關閉一個模型，請點選模型標籤頁中的 X 按鈕。如果打開了多個模型，您也可以點選“關閉所有”來關閉所有模型。

模型中資料型別的圖示

每個欄位的資料型別都透過標題中的圖標表示。

下表列出了所有資料型別及其識別圖示。

欄位資料型別	描述
	文字
	整數
	日期時間
	布林值
	預定義值列表（enum 資料型別）
	來自另一個模型的相關記錄列表
	{} 符號可以指以下兩種欄位型別之一。 • 關聯欄位 • JSON 欄位

模型中的鍵盤快捷鍵

當您開啟一個模型時，可以使用多種鍵盤快捷鍵來瀏覽和操作模型中的資料。

資訊

注意

在 Prisma Studio 開啟時，您可以透過在 macOS 上按 Cmd ⌘+/ 或在 Windows 上按 Ctrl+/ 來開啟鍵盤快捷鍵模態框。

編輯資料

Prisma Studio 提供兩種編輯現有資料的機制：內聯編輯和側面板編輯。

內聯編輯

要內聯編輯資料，雙擊一個單元格進入編輯模式。這樣做會將您的游標置於單元格中，並允許您編輯資料。資料可以被複制和貼上到單元格中。

所有更改（新增、編輯或刪除）都必須確認後才能生效。使用“儲存更改”按鈕確認新增和編輯的記錄。當您選擇記錄並點選“刪除記錄”時，請在對話方塊中確認刪除。

您可以累積多個新增的記錄和編輯過的單元格，然後透過“儲存更改”按鈕將其最終確定。

完成資料編輯後，點選綠色的“儲存”按鈕。

批次編輯

可以同時編輯多條記錄。雙擊任意單元格即可編輯值，並根據需要移動到其他單元格。完成後，點選綠色的“儲存”按鈕。

側面板編輯

Prisma Studio 還提供一個用於編輯資料的側面板。要開啟側面板，請點選位於每個可見記錄最左側選擇複選框旁邊的“編輯側面板”圖示。

點選圖示將在右側開啟側面板，您可以在其中進行編輯。完成後，點選側面板外部，然後點選綠色的“儲存”按鈕以儲存更改。

刪除記錄

1. 從左側列中，選擇您要刪除的記錄對應的複選框。
2. 點選“刪除 n 條記錄”。
3. 在確認對話方塊中點選“刪除”。

您可以選擇多條記錄並使用“刪除記錄”按鈕一次性刪除它們。當您刪除多條記錄時，操作會立即完成（在您確認後）。

此外，如果您有任何累積的新增或編輯記錄，然後決定刪除記錄，刪除操作也會強制儲存這些累積的編輯。

警告

警告

刪除記錄是一個獨立的操作，不能累積。如果您在有未儲存編輯的情況下刪除記錄，刪除操作將首先強制儲存未儲存的編輯，然後完成。

您可以使用“丟棄更改”按鈕放棄任何累積的更改。

複製和貼上

您可以使用以下方式複製任何表格單元格的值

• Cmd ⌘ + C   在 macOS 上
• Ctrl + C     在 Windows 上

要貼上到另一個單元格中，請先雙擊該單元格進入編輯模式，然後使用

• Cmd ⌘ + V   在 macOS 上
• Ctrl + V     在 Windows 上

新增記錄

1. 在模型檢視中，點選“新增記錄”。

2. 根據每個欄位允許的資料型別，輸入記錄的資料。

   欄位資料型別	描述
   	文字
   	整數 如果某個欄位預填充了 autoincrement()，請勿編輯該單元格，也不要手動新增數字。
   	日期時間 日期時間欄位包含一長串數字、字母和其他字元。最佳實踐是，複製另一個日期時間單元格的值，並在貼上到該欄位之前根據需要進行修改。
   	布林值 選擇 true 或 false。
   	預定義列表 雙擊欄位中的單元格，然後選擇一個預定義選項。
   	來自另一個模型的相關記錄列表 它通常指資料庫中另一個模型中存在的一系列記錄。如果您正在新增新記錄，並且相關模型中的記錄尚不存在，則無需在當前模型中輸入任何內容。
   	{} 符號可以指以下兩種欄位型別之一。 • 關聯欄位 • JSON 欄位 與資料庫中獨立定義的模型的關聯 通常，您需要選擇與任何現有記錄相同的值 點選模型的名稱以檢視值列表，然後您可以為關聯欄位選擇其中一個。 JSON 欄位 雙擊欄位以編輯 JSON 資料。最佳實踐是，在驗證器中驗證編輯後的 JSON 資料，然後將其貼上回單元格。

3. （可選）如果您對更改不滿意，點選“丟棄更改”並重新開始。

4. 點選“儲存 1 處更改”。

篩選器

篩選資料

使用“篩選器”選單透過新增條件來篩選模型中的資料。

在“篩選器”選單中，您新增的第一個條件是 where 子句。

當您新增多個條件時，Prisma Studio 會過濾結果，以便所有條件組合應用。每個新條件都會通過出現在其前面的 and 運算子來表示。

步驟

1. 點選“篩選器”以開啟“篩選器”選單。

   資訊

   注意
   如果您想隱藏選單，再次點選“篩選器”。

2. 點選“新增新篩選器”。

3. 配置條件。

   1. 選擇您要篩選的欄位。
   2. 選擇一個比較運算子。
      • 等於
      • 在...中
      • 不在...中
      • 小於
      • 小於等於
      • 大於
      • 大於等於
      • 不等於
   3. 輸入您想用於條件的值。
      步驟結果：Prisma Studio 會根據條件立即更新模型中的資料。

4. 要新增新篩選器，請點選“新增新篩選器”並重覆上述步驟。

5. 要刪除篩選器，點選右側的 x 按鈕。

6. 要刪除所有篩選器，點選“清除所有”。

結果

• 模型中的資料將根據您新增的所有條件的組合進行篩選。
• 在“篩選器”選單中，預設值“無”會更改為顯示您新增的篩選器數量。

顯示和隱藏欄位

您可以使用“欄位”選單選擇要顯示或隱藏的欄位。

資訊

什麼是欄位？

欄位是您在 Prisma schema 檔案的資料模型定義中新增的模型屬性。根據您使用的資料庫，一個欄位（例如 model User { title String } 中的 title 欄位）在關係型資料庫（PostgreSQL、MySQL、SQL Server、SQLite、CockroachDB）中指代列，在 MongoDB 中則指代文件欄位。
欲瞭解更多資訊，請參閱 定義欄位。

步驟

1. 點選“欄位”選單。
2. 僅選擇您想看到的欄位，並取消選擇您想隱藏的任何欄位。

結果

模型會立即被篩選，以隱藏您已取消選擇的任何欄位的資料。

此外，“欄位”選單會顯示當前選中的欄位數量。

顯示和隱藏記錄

您還可以選擇在模型檢視中顯示或跳過特定數量的記錄。

資訊

什麼是記錄？

記錄指關係型資料庫（PostgreSQL、MySQL、SQL Server、SQLite、CockroachDB）中表格中的一行資料，或 MongoDB 中的文件。

步驟

1. 點選“顯示”選單。
2. 在“獲取”框中，指定您希望模型檢視顯示的最大記錄數量。
3. 在“跳過”框中，指定您要隱藏的初始記錄數量。

結果

模型會立即根據您的選擇篩選以顯示或隱藏記錄。

“顯示”選單指示模型中顯示的記錄數量佔可用記錄總數的比例。

排序資料

點選欄位標題以按欄位資料排序。

首次點選按升序排序資料，第二次點選按降序排序。

故障排除

終端：執行指令碼失敗 / Prisma Client 請求錯誤

快取問題可能導致 Prisma Studio 使用舊版本的查詢引擎。您可能會看到以下錯誤：

Error in request:  PrismaClientKnownRequestError: Failed to validate the query Error occurred during query validation & transformation

要解決此問題，請刪除以下資料夾：

• macOS 和 Linux 上為 ~/.cache/prisma
• Windows 上為 %AppData%/Prisma/Studio