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