Files
dbx/docs/content/docs/data-grid.cn.mdx
T
2026-05-09 19:02:20 +08:00

76 lines
2.4 KiB
Plaintext

---
title: 数据表格
description: 在 DBX 中浏览、筛选、编辑、预览 SQL 并导出表数据。
---
数据表格用于查看查询结果或表数据。它适合处理两类场景:快速浏览数据,以及在确认 SQL 后进行小范围数据修改。
## 浏览数据
DBX 使用虚拟滚动渲染表格,只渲染当前可视区域内的行。大表浏览时,滚动和选择操作不会因为一次性渲染所有行而明显变慢。
常用浏览操作:
- 拖拽列边缘调整列宽
- 双击列边缘根据内容自适应列宽
- 点击列头排序
- 使用行号定位数据
- 打开单元格详情查看长文本、JSON 或其他复杂值
## 过滤与排序
| 功能 | 适合场景 |
|---|---|
| 搜索 | 在当前结果中快速定位包含关键字的行 |
| WHERE | 在数据库层面筛选数据,适合大表和精确条件 |
| ORDER BY | 在数据库层面排序,适合稳定复现查询结果 |
<Callout type="info">
大表场景优先使用 `WHERE` 和 `ORDER BY`。它们在数据库层面执行,通常比客户端搜索更稳定。
</Callout>
## 行内编辑
可以直接在表格里修改数据:
- **修改单元格**:双击单元格进入编辑状态
- **新增行**:在表格中添加一行待插入记录
- **删除行**:选中行后标记为待删除
- **设置 NULL**:在单元格详情面板中明确写入 `NULL`
所有修改都会先暂存在本地。保存前,DBX 会展示即将执行的 SQL。
## SQL 预览
<Callout type="warn">
数据修改不会在编辑后立即写入数据库。点击保存前,请先检查 SQL 预览,尤其是在生产环境连接上。
</Callout>
SQL 预览会展示 `UPDATE`、`INSERT` 或 `DELETE` 语句。这个步骤可以帮助你确认:
- 更新条件是否正确
- 新增行的字段是否完整
- 删除操作是否命中预期行
- `NULL`、空字符串和默认值是否符合预期
## 单元格详情
点击单元格可以打开详情面板。它适合处理表格内不方便直接编辑的值:
- 长文本
- JSON
- SQL 片段
- 多行内容
- 需要显式设置为 `NULL` 的字段
## 导出与复制
| 格式 | 用途 |
|---|---|
| CSV | 给 Excel、Numbers 或其他表格工具使用 |
| JSON | 给脚本、接口调试或程序处理使用 |
| Markdown | 粘贴到 Issue、PR、文档或聊天中 |
| INSERT | 将选中行复制为可执行的 `INSERT` 语句 |
导出前建议先确认当前筛选和排序条件,避免导出范围和预期不一致。