Prisma Studio
Prisma Studio 是用於資料庫中資料的可視化編輯器。請注意，Prisma Studio 不是開放原始碼，但您仍然可以在 prisma/studio 儲存庫中建立 issue。
在您的終端機中執行 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 也提供用於編輯資料的側邊面板。若要開啟側邊面板，請點擊位於每個可見記錄最左側的選取核取方塊旁邊的編輯側邊面板圖示。
點擊圖示將會在右側開啟側邊面板，您可以在其中執行編輯。完成後，點擊側邊面板外部，然後點擊綠色的儲存按鈕以儲存變更。
刪除記錄
- 從左欄中，選取您要刪除的記錄的核取方塊。
- 點擊刪除 n 筆記錄。
- 在確認對話方塊中點擊刪除。
您可以選取多個記錄，並使用刪除記錄按鈕一次刪除它們。當您刪除多個記錄時，操作會立即完成（在您確認之後）。
此外，如果您有任何累積的新增或編輯的記錄，然後決定刪除記錄，則刪除也會強制儲存累積的編輯。
警告
刪除記錄是獨立的操作，無法累積。如果您在有未儲存的編輯時刪除記錄，則刪除操作會先強制儲存未儲存的編輯，然後完成。
您可以使用捨棄變更按鈕捨棄任何累積的變更。
複製和貼上
您可以使用以下方式複製任何表格儲存格的值
- Cmd ⌘ + C 在 macOS 上
- Ctrl + C 在 Windows 上
若要貼到另一個儲存格中，請先雙擊該儲存格以進入編輯模式，然後使用
- Cmd ⌘ + V 在 macOS 上
- Ctrl + V 在 Windows 上
新增記錄
-
在模型檢視中，點擊新增記錄。
-
根據每個欄位中允許的資料，輸入記錄的資料。
欄位資料類型 描述 文字 整數
如果此類欄位已預先填寫autoincrement()，請勿編輯儲存格，也不要手動新增數字。日期時間
日期時間欄位包含一長串數字、字母和其他字元。最佳實務是複製另一個日期時間儲存格的值，並根據需要修改它，然後再貼到欄位中。布林值
選取true或false。預先定義的列表
雙擊欄位中的儲存格，然後選取其中一個預先定義的選項。來自另一個模型的相關記錄列表
它通常指的是資料庫中另一個模型中存在的記錄列表。如果您要新增一個新記錄，且相關模型中的記錄尚不存在，則您無需在目前的模型中輸入任何內容。{}符號可以指兩種欄位類型之一。
• 關聯欄位
• JSON 欄位
與資料庫中單獨定義的模型的關聯
通常，您需要選取與任何先前記錄相同的值
點擊模型名稱以查看值列表，然後您可以為相關欄位選取這些值。
JSON 欄位
雙擊欄位以編輯 JSON 資料。最佳實務是在驗證器中驗證編輯後的 JSON 資料，然後將其貼回儲存格中。 -
（選用）如果您對變更不滿意，請點擊捨棄變更並重新開始。
-
點擊儲存 1 個變更。
篩選器
篩選資料
使用篩選器選單，透過新增條件來篩選模型中的資料。
在篩選器選單中，您新增的第一個條件是 where 子句。
當您新增多個條件時，Prisma Studio 會篩選結果，以便所有條件組合適用。每個新條件都使用 and 運算子來表示這一點，該運算子會出現在前面。
步驟
-
點擊篩選器以開啟篩選器選單。
資訊注意
如果您想要隱藏選單，請再次點擊篩選器。 -
點擊新增篩選器。
-
配置條件。
- 選取您要依其篩選的欄位。
- 選取比較運算子。
- 等於
- 在其中
- 不在其中
- 小於
- 小於或等於
- 大於
- 大於或等於
- 非
- 輸入您要用於條件的值。
步驟結果：Prisma Studio 會根據條件立即更新模型中的資料。
-
若要新增新的篩選器，請點擊新增篩選器並重複上述步驟。
-
若要移除篩選器，請點擊右側的 x 按鈕。
-
若要移除所有篩選器，請點擊全部清除。
結果
- 模型中的資料會根據您新增的所有條件的組合進行篩選。
- 在篩選器選單中，無的預設值會變更為顯示您新增的篩選器數量。
顯示和隱藏欄位
您可以使用欄位選單來選取要檢視或隱藏的欄位。
什麼是欄位？
欄位是模型的屬性，您可以在 Prisma schema 檔案中的資料模型定義中新增。根據您使用的資料庫，欄位（例如 model User { title String } 中的 title 欄位）指的是關聯式資料庫（PostgreSQL、MySQL、SQL Server、SQLite、CockroachDB）中的資料行或 MongoDB 中的文件欄位。
如需更多資訊，請參閱定義欄位。
步驟
- 點擊欄位選單。
- 僅選取您想要看到的欄位，並取消選取您想要隱藏的任何欄位。
結果
模型會立即篩選，以隱藏您已取消選取的任何欄位的資料。
此外，欄位選單會顯示目前選取的欄位數量。
顯示和隱藏記錄
您也可以選取在模型檢視中顯示或略過特定數量的記錄。
什麼是記錄？
記錄指的是關聯式資料庫（PostgreSQL、MySQL、SQL Server、SQLite、CockroachDB）中表格中的資料列或 MongoDB 中的文件。
步驟
- 點擊顯示選單。
- 在取得方塊中，指定您希望模型檢視顯示的最大記錄數。
- 在略過方塊中，指定您想要隱藏的前幾個記錄的數量。
結果
模型會立即篩選，以根據您的選取顯示或隱藏記錄。
顯示選單會指示在模型中可用的記錄總數中顯示了多少記錄。
排序資料
點擊欄位標題以依欄位資料排序。
第一次點擊會以升序排序資料，第二次點擊則以降序排序。
疑難排解
終端機：無法執行腳本 / 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