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