Studio 数据浏览与编辑:筛选、排序、增删记录
界面概览
启动 Studio 后你会看到:
- 左侧栏:列出 Schema 里定义的所有 model(User、Post、Comment 等),点击切换
- 主区域:显示当前 model 的数据表格
- 顶栏:搜索框、筛选按钮、排序控件、导出按钮、+号(添加记录)
Studio 会根据 Schema 里的字段类型自动渲染合适的编辑器控件——DateTime 字段显示日期选择器、Boolean 显示开关、enum 显示下拉选择。
浏览数据
切换模型
左侧栏点击不同的 model 名称,主区域就切换显示那个表的数据。每个 model 旁边显示总记录数。
搜索
顶栏的搜索框可以按任意字段模糊搜索。比如在 User 模型里输入 @company.com,会过滤所有 email 包含这个字符串的用户。
排序
点击列标题可以按该列升序/降序排序。再点一次反向排序。
分页
如果记录很多,Studio 底部有分页控件。默认每页显示 20 条,可以在设置里改。
筛选
点击顶栏的筛选图标(漏斗形状)打开筛选面板:
- 字段选择:选要筛选的字段
- 运算符:
equals、contains、startsWith、in、>=、<=等 - 多条件:添加多个筛选条件,用 AND 或 OR 组合
比如筛选"role 是 USER 且 email 以 @company.com 结尾":
role equals USER AND email endsWith @company.com
编辑数据
双击单元格
直接双击任意单元格就能编辑。修改后 Studio 会自动保存(调用 Prisma Client 的 update)。
编辑时会做基本校验:
- 类型错误(比如往
Int字段输入字母)会显示红色提示 - 必填字段如果清空会提示不能为空
- 唯一约束冲突会提示并阻止保存(对应 Prisma Client 的 P2002 错误)
添加新记录
点击顶栏的 + 号,Studio 会弹一个表单让你填写新记录。必填字段标红星,填完点保存。
删除记录
勾选表格每行左侧的复选框,然后点顶栏的垃圾桶图标。可以批量删除。Studio 会先弹确认框防止误删。
撤销 / 重做
Studio 支持最近操作的撤销和重做(Ctrl+Z / Ctrl+Y)。
关系导航
这是 Studio 的杀手级功能之一——直观地查看和操作模型之间的关系。
查看关联记录
如果 Post 有一个 author 字段关联 User,Studio 在 Post 列表里会显示一个可展开的行。点击 author 旁边的 展开图标,就能看到关联的 User 详情。
反向也一样:在 User 详情页里可以直接看到他的所有 Post。
编辑关系
在编辑记录时,关系字段显示为可搜索的选择器。输入关键字就能从关联表中挑选记录 connect。
行内快速创建
如果关联记录还不存在,可以在 Studio 里跨表快速创建:
- 编辑 Post 时,author 字段旁边有个 "+" 按钮
- 点击后弹出快速创建 User 的表单
- 创建完成后自动 connect 到当前 Post
这省去了"切到 User 模型创建 → 切回 Post 再 connect"的麻烦。
快捷键
| 操作 | 快捷键 |
|---|---|
| 打开筛选 | Ctrl+Shift+F |
| 添加记录 | N |
| 保存 | Ctrl+Enter |
| 撤销 | Ctrl+Z |
| 重做 | Ctrl+Y |
| 切换模型 | Ctrl+P(命令面板) |