Prisma Studio

Prisma Studio 是一个用于数据库中数据的可视化编辑器。请注意，Prisma Studio 不是开源的，但您仍然可以在 prisma/studio 存储库中创建问题。

在您的终端中运行 npx prisma studio。

模型（表或集合）

首次打开 Prisma Studio 时，您会看到 Prisma 模式文件中定义的所有模型的列表。

信息

什么是模型？

术语**模型**指的是您添加到 Prisma 模式文件中的数据模型定义。根据您使用的数据库，模型定义（例如 model User）指的是关系数据库（PostgreSQL、MySQL、SQL Server、SQLite、CockroachDB）中的**表**或 MongoDB 中的**集合**。

有关更多信息，请参阅 定义模型。

您可以选择一个模型，其数据将在新选项卡中打开。

打开和关闭模型

要打开另一个模型，请单击**+**按钮。

要关闭模型，请单击模型选项卡中的**x**按钮。

模型中数据类型的图标

每个字段的数据类型在标题中用图标表示。

下表列出了所有数据类型及其识别图标。

字段数据类型	描述
	文本
	整数
	日期时间
	布尔值
	预定义的值列表（enum 数据类型）
	来自另一个模型的相关记录列表
	{} 符号可以指代两种类型的字段之一。 • 关系字段 • JSON 字段

模型中的键盘快捷键

打开模型后，可以使用一些键盘快捷键来浏览和操作模型中的数据。

信息

注意

在 Prisma Studio 打开的情况下，您可以通过在 macOS 上按 Cmd ⌘+/ 或在 Windows 上按 Ctrl+/ 来打开键盘快捷键模态。

编辑数据

在模型视图中，您可以直接在模型单元格中编辑数据。您可以在单元格中复制和粘贴值。您还可以添加新记录以及删除现有记录。

您必须确认每个编辑操作（添加、编辑或删除）。您可以使用**保存更改**按钮确认已添加和编辑的记录。当您选择记录并单击**删除记录**时，您将在对话框中确认删除操作。

您可以累积多个已添加的记录和已编辑的单元格，然后可以使用**保存更改**按钮完成这些操作。

您可以选择多个记录并使用**删除记录**按钮一次性删除它们。当您删除多个记录时，操作会立即完成（在您确认后）。

此外，如果您有任何累积的已添加或已编辑的记录，然后决定删除记录，则删除操作也会强制保存累积的编辑。

您可以使用**放弃更改**按钮放弃任何累积的更改。

复制和粘贴

您可以使用以下方法复制任何表格单元格的值

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

要在另一个单元格中粘贴，首先双击单元格以进入编辑模式，然后使用

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

添加记录

1. 在模型视图中，单击**添加记录**。

2. 根据每个字段允许的数据，键入记录的数据。

   字段数据类型	描述
   	文本
   	整数 如果此类字段预先填充了 autoincrement()，请不要编辑单元格，也不要手动添加数字。
   	日期时间 日期时间字段包含一长串数字、字母和其他字符。作为最佳实践，请复制另一个日期时间单元格的值，并在必要时进行修改，然后再粘贴到字段中。
   	布尔值 选择 true 或 false。
   	预定义列表 双击字段中的单元格，然后选择预定义选项之一。
   	来自另一个模型的相关记录列表 它通常指的是数据库中另一个模型中存在的记录列表。如果您正在添加新记录，并且相关模型中的记录尚不存在，则无需在当前模型中输入任何内容。
   	{} 符号可以指代两种类型的字段之一。 • 关系字段 • JSON 字段 与数据库中单独定义的模型的关系 通常，您需要选择与任何先前记录相同的值 单击模型的名称以查看值的列表，然后您可以从中选择相关字段的值。 JSON 字段 双击字段以编辑 JSON 数据。作为最佳实践，请在验证器中验证已编辑的 JSON 数据，然后将其粘贴回单元格中。

3. （可选）如果您对更改不满意，请单击**放弃更改**并重新开始。

4. 单击**保存 1 处更改**。

编辑记录

1. 双击包含现有数据的单元格以进行编辑。
2. （可选）如果您对更改不满意，请单击**放弃更改**并重新开始。
3. 单击**保存 1 处更改**。

删除记录

1. 从左侧列中，选中要删除的记录的复选框。
2. 单击**删除 1 处记录**。
3. 在确认对话框中单击**删除**。

一次编辑多条记录

您可以添加多条记录、编辑多个单元格，从而累积多个编辑。

最后，单击**保存更改**以完成这些操作。

警告

警告

删除记录是一个单独的操作，不能累积。如果您在有未保存的编辑时删除记录，则删除操作会首先强制保存未保存的编辑，然后完成。

过滤器

筛选数据

使用**过滤器**菜单通过添加条件来筛选模型中的数据。

在**过滤器**菜单中，您添加的第一个条件是 where 子句。

当您添加多个条件时，Prisma Studio 会筛选结果，以便所有条件组合应用。每个新条件都会在前面显示 and 运算符，以此指示这一点。

步骤

1. 单击**过滤器**以打开**过滤器**菜单。

   信息

   注意
   如果您想隐藏菜单，请再次单击**过滤器**。

2. 单击**添加新过滤器**。

3. 配置条件。

   1. 选择要筛选的字段。
   2. 选择比较运算符。
      • 等于
      • 在
      • 不在
      • 小于
      • 小于等于
      • 大于
      • 大于等于
      • 不
   3. 键入要用于条件的值。
      **步骤结果**：**Prisma Studio**会根据条件立即更新模型中的数据。

4. 要添加新过滤器，请单击**添加新过滤器**并重复上述步骤。

5. 要删除过滤器，请单击右侧的**x**按钮。

   

6. 要删除所有过滤器，请单击**清除所有**。

结果

• 模型中的数据将根据您添加的所有条件的组合进行筛选。

• 在**过滤器**菜单中，**无**的默认值会更改为显示您添加的过滤器数量。

显示和隐藏字段

您可以使用**字段**菜单选择要查看或隐藏的字段。

信息

什么是字段？

**字段**是模型的一个属性，您可以在 Prisma 模式文件中数据模型定义中添加它。根据您使用的数据库，字段（例如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 客户端请求错误

缓存问题可能会导致 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