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