数据表格
在 DBX 中浏览、筛选、编辑、预览 SQL 并导出表数据。
数据表格用于查看查询结果或表数据。它适合处理两类场景：快速浏览数据，以及在确认 SQL 后进行小范围数据修改。
浏览数据
DBX 使用虚拟滚动渲染表格，只渲染当前可视区域内的行。大表浏览时，滚动和选择操作不会因为一次性渲染所有行而明显变慢。
常用浏览操作：
- 拖拽列边缘调整列宽
- 双击列边缘根据内容自适应列宽
- 点击列头排序
- 使用行号定位数据
- 打开单元格详情查看长文本、JSON 或其他复杂值
过滤与排序
| 功能 | 适合场景 |
|---|---|
| 搜索 | 在当前结果中快速定位包含关键字的行 |
| WHERE | 在数据库层面筛选数据，适合大表和精确条件 |
| ORDER BY | 在数据库层面排序，适合稳定复现查询结果 |
WHERE 和 ORDER BY。它们在数据库层面执行，通常比客户端搜索更稳定。行内编辑
可以直接在表格里修改数据：
- 修改单元格：双击单元格进入编辑状态
- 新增行：在表格中添加一行待插入记录
- 删除行：选中行后标记为待删除
- 设置 NULL：在单元格详情面板中明确写入
NULL
所有修改都会先暂存在本地。保存前，DBX 会展示即将执行的 SQL。
什么时候可以编辑
当 DBX 能识别目标表，并且有足够的键信息生成可审查的 UPDATE、INSERT 或 DELETE 语句时，结果才可编辑。直接打开表数据通常可以编辑；临时 join、聚合、表达式或没有可用主键/行标识的结果会视为只读。
| 结果类型 | 通常行为 |
|---|---|
| 打开的表数据 | 数据库和表支持时可编辑 |
简单 SELECT * FROM table | 有主键或行标识时通常可编辑 |
| Join、聚合、计算列 | 只读结果 |
| Redis 或 MongoDB 视图 | 使用对应专用编辑器，不走关系型行 SQL |
SQL 预览
SQL 预览会展示 UPDATE、INSERT 或 DELETE 语句。这个步骤可以帮助你确认：
- 更新条件是否正确
- 新增行的字段是否完整
- 删除操作是否命中预期行
NULL、空字符串和默认值是否符合预期
如果预览 SQL 的影响范围过大，请取消保存，先缩小筛选条件或选择范围。
单元格详情
点击单元格可以打开详情面板。它适合处理表格内不方便直接编辑的值：
- 长文本
- JSON
- SQL 片段
- 多行内容
- 需要显式设置为
NULL的字段
转置视图
切换转置视图可互换行和列。适用场景：
- 表有很多列但行数较少
- 需要并排比较列的元数据（类型、默认值、可空标志）
- 查看具有宽列的单个行
转置视图保留所有表格功能：排序、过滤、编辑和导出均可正常使用。
列格式化器
自定义列格式化器让你控制特定列值的显示方式：
- 日期时间格式化：为日期和时间列选择显示格式
- JSON 路径提取：使用 JSONPath 表达式从 JSON/JSONB 列中提取特定字段
- 值掩码：隐藏或部分掩码敏感值
- 自定义模板：为列定义自己的显示模板
从列头菜单配置格式化器。格式化器仅影响显示——不会更改底层数据。
单元格详情编辑器
单元格详情面板为单个单元格值提供完整的编辑器：
- 值编辑器：在更大的文本区域中编辑单元格内容，JSON 和 SQL 具有语法高亮
- 设置 NULL：将单元格显式设置为 NULL
- 图片预览：当单元格包含图片 URL 时，详情面板会显示渲染后的预览
- 时间编辑器：日期和时间单元格使用专用的日期/时间选择器
多行操作
选中多行执行批量操作：
- 批量克隆：一次性复制多行
- 批量删除：一次性标记多行为待删除
- 批量复制：以 TSV、CSV、JSON、Markdown 或 INSERT 语句格式复制多行
- 复制为 INSERT：生成包含多行值的单条
INSERT语句 - 复制为 UPDATE：为选中的行生成
UPDATE语句 - 复制不含主键：生成排除自增主键的 INSERT 语句
列头控件
列头提供快速操作入口：
- 排序：点击切换升序、降序或清除排序。右键点击可打开排序上下文菜单。
- 列可见性：从可搜索的清单中显示或隐藏列
- 本地列过滤：通过勾选特定值在当前结果集中过滤
- 紧凑模式：在设置中启用后，列头操作（排序、格式化、过滤）收起为单个下拉菜单，给列名留出更多空间
- 紧凑过滤构建器：在紧凑 UI 中使用多个条件构建复杂的客户端过滤
- 拖放列重排序：点击并拖动列头即可重新排序。列顺序按表/查询保存，跨会话持久化
单元格详情编辑器
单元格详情面板为单个单元格值提供完整的编辑器：
- 值编辑器：在更大的文本区域中编辑单元格内容，JSON 和 SQL 具有语法高亮
- 设置 NULL：将单元格显式设置为 NULL
- 图片预览：当单元格包含图片 URL 时，详情面板会显示渲染后的预览
- 时间编辑器：日期和时间单元格使用专用的日期/时间选择器
- 二进制数据十六进制查看器：以十六进制格式查看二进制数据，同时显示十六进制和 ASCII 表示，便于检查原始二进制内容
导出与复制
| 格式 | 用途 |
|---|---|
| CSV | 给 Excel、Numbers 或其他表格工具使用 |
| JSON | 给脚本、接口调试或程序处理使用 |
| Markdown | 粘贴到 Issue、PR、文档或聊天中 |
| INSERT | 将选中行复制为可执行的 INSERT 语句（支持单行或批量） |
| UPDATE | 将选中行复制为可执行的 UPDATE 语句 |
| XLSX | 从表格上下文菜单直接导出为 Excel 格式 |
复制带表头
DBX 支持在复制数据时包含列头：
- 复制列名：只复制当前选择的列名
- 复制选择区域与表头：复制选中的单元格及其列头
- 复制为带表头的 TSV/CSV：在制表符分隔或逗号分隔输出中包含表头
这在将数据粘贴到电子表格、文档或分享查询结果时特别有用，可以保留列的上下文信息。
导出前建议先确认当前筛选和排序条件，避免导出范围和预期不一致。
分页与大结果集
DBX 会通过分页和虚拟滚动让大结果集保持响应。面对大表时，优先使用数据库侧的 WHERE 和 ORDER BY，不要只依赖客户端搜索；数据库可以利用索引，并返回更小的结果集。分页大小可配置并跨会话持久化。
行号显示
数据表格在最左侧列显示行号。在翻页浏览大结果集时，行号会反映当前页面位置，帮助你跟踪正在查看的记录。当应用排序或筛选时，行号会自动调整。