跳转到主要内容

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 中的 集合。

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

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

Prisma Studio - Models view

打开和关闭模型​

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

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

Prisma Studio - Open and close models

模型中数据类型的图标​

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

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

字段数据类型描述
文本
整数
日期时间

布尔值
预定义的值列表（enum 数据类型）
来自另一个模型的关联记录列表
{} 符号可以指以下两种类型的字段之一。

• 关系字段
• JSON 字段

模型中的键盘快捷键​

当您打开一个模型时，可以使用许多键盘快捷键来浏览和操作模型中的数据。

信息

注意

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

Prisma Studio - Keyboard shortcuts

编辑数据​

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

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

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

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

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

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

复制和粘贴​

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

  • 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. 在确认对话框中单击 删除。

一次编辑多个记录​

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

最后，单击 保存更改 以完成它们。

警告

警告

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

Prisma Studio - Save multiple data edits

筛选器​

筛选数据​

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

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

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

步骤

  1. 单击 筛选器 以打开 筛选器 菜单。

    信息

    注意
    如果想隐藏菜单，请再次单击 筛选器。

  2. 单击 添加新筛选器。

  3. 配置条件。

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

  4. 要添加新筛选器，请单击 添加新筛选器 并重复上述步骤。

  5. 要删除筛选器，请单击右侧的 x 按钮。

    Prisma Studio - add and remove filters

  6. 要删除所有筛选器，请单击 全部清除。

结果

  • 模型中的数据会根据您添加的所有条件的组合进行筛选。
  • 在 筛选器 菜单中，无 的默认值会更改为显示您添加的筛选器数量。

显示和隐藏字段​

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

信息

什么是字段？

字段 是模型的一个属性，您可以在 Prisma schema 文件的数据模型定义中添加它。根据您使用的数据库，一个字段，例如 model User { title String } 中的 title 字段，在关系数据库（PostgreSQL、MySQL、SQL Server、SQLite、CockroachDB）中指的是一个 列，在 MongoDB 中指的是一个 文档字段。
有关更多信息，请参阅 定义字段。

步骤

  1. 单击 字段 菜单。
  2. 仅选择您想要看到的字段，并取消选择您想要隐藏的字段。 Prisma Studio - show and hide fields

结果

模型会立即被过滤，以隐藏您取消选择的任何字段的数据。

此外，字段 菜单还会显示当前选中的字段数量。

显示和隐藏记录​

您还可以选择在模型视图中显示或跳过特定数量的记录。

信息

什么是记录？

记录 指的是关系数据库（PostgreSQL、MySQL、SQL Server、SQLite、CockroachDB）中 表中的一行数据，或 MongoDB 中的 文档。

步骤

  1. 单击 正在显示 菜单。
  2. 在 选取 框中，指定您希望模型视图显示的最大记录数。
  3. 在 跳过 框中，指定您要隐藏的前多少条记录。 Prisma Studio - Show and hide records

结果

模型会立即被过滤，以根据您的选择显示或隐藏记录。

正在显示 菜单会指示模型中显示的记录数和可用记录总数。

排序数据​

单击字段标题以按字段数据排序。

第一次单击按升序排序数据，第二次单击按降序排序。

Prisma Studio - Sort data

故障排除​

终端：脚本运行失败 / 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