DBX

数据表格

数据表格用于显示查询结果和表数据。它同时覆盖只读分析和小范围数据修改：浏览大结果集、筛选排序、检查复杂值、批量复制，以及在 DBX 能可靠识别目标行时生成并预览 INSERT、UPDATE 或 DELETE。

Redis、MongoDB、向量数据库、HBase 等系统使用各自的专项数据界面。这里主要说明关系型和兼容 SQL 数据源的结果表格。

浏览与布局

DBX 使用虚拟滚动，只渲染当前可视区域。常用浏览操作包括：

  • 拖拽列边缘调整宽度，或双击按内容自适应
  • 拖拽列头重排顺序，并按表或查询保存布局
  • 冻结左侧或右侧列，横向滚动时保留关键字段
  • 显示、隐藏和搜索列；搜索可以同时匹配列名和字段注释
  • 调整表格字体、字号、行高和列宽密度
  • 在标准视图与转置视图之间切换
  • 查看连接名、结果来源、字段类型和字段注释

列宽、列顺序、冻结状态和多个显示选项可以跨会话保留。需要恢复时，在视图选项中重置当前表格布局。

过滤、搜索与排序

方式执行位置适合场景
表格搜索当前已加载结果快速定位文本、字段值或字段注释
本地值过滤当前已加载结果临时勾选值、列表或范围，不重新查询数据库
WHERE数据库大表、精确条件、可使用索引的筛选
ORDER BY数据库跨页稳定排序和可复现结果
当前页排序客户端当前页临时比较已加载数据，不改变数据库查询

WHERE 和 ORDER BY 输入支持较长表达式、折叠/展开和基于字段元数据的条件补全。可以在设置中配置打开表时的默认排序。

面对大表时，优先使用数据库侧 WHERE 和 ORDER BY。客户端搜索、值过滤和当前页排序不会减少数据库实际返回的数据量。

什么时候可以编辑

只有当 DBX 能识别目标表，并有足够的主键或行标识生成可审查 SQL 时，结果才可编辑。

结果类型通常行为
从对象树直接打开的表数据数据库和表支持时可编辑
简单 SELECT能解析单一目标表且有可靠行标识时可编辑
Join、聚合、表达式、计算列通常只读
没有主键或可靠唯一标识通常只读，避免生成不安全条件
连接被标记为只读所有可识别修改都被拒绝

只读单元格仍可以打开详情、复制和导出。需要了解无法编辑的原因时，查看数据表头和单元格详情中的只读说明。

编辑、新增与删除

  • 修改单元格：双击进入编辑，或在详情面板中处理长文本
  • 新增行：创建一行或多行待插入记录
  • 批量粘贴：把制表符分隔的数据直接粘贴到新增行区域
  • 克隆行：复制选中记录作为新行，并按需要排除主键
  • 删除行：把选中记录标记为待删除
  • 设置 NULL：明确写入数据库 NULL，与空字符串区分
  • 使用默认值：让新增字段使用数据库默认值（数据库和字段支持时）
  • 生成值：为选中单元格使用内置数据生成器填充测试值

日期时间、枚举、JSON 和其他类型会在可识别时使用专用编辑控件。批量编辑前应确认所选区域和目标字段类型一致。

SQL 预览与保存

所有关系型数据修改先保存在本地待提交状态。点击保存时，DBX 会展示生成的 INSERT、UPDATE 和 DELETE SQL。

保存前重点检查：

  • UPDATE 和 DELETE 的主键或条件是否只命中目标行
  • 新增行是否遗漏必填字段
  • NULL、空字符串、默认值和自动生成值是否符合预期
  • 批量操作是否包含了未注意到的行
  • 当前连接和数据库是否正确

生产环境保护启用后，保存仍会进入统一的生产写入确认。完整规则见 生产环境与写入安全。

SQL 预览是最后检查点，不是事务审批系统。重要生产变更仍应使用最小权限账号、备份和团队变更流程。

单元格详情与复杂值预览

单元格详情用于表格内不适合直接显示或编辑的值：

  • 长文本、多行文本、SQL 和带语法高亮的 JSON
  • JSON 格式化、压缩和路径查看
  • 二进制值的十六进制与 ASCII 查看
  • 图片 URL、图片二进制或可识别图像数据预览
  • 日期、时间和带时区值的专用编辑与格式化
  • 几何/空间数据的文本、坐标和地图预览，包括可识别的 SRID
  • 被截断值、只读值和字段元数据说明

详情面板中的格式化和预览通常只影响显示；真正修改值时，仍会进入待保存状态并生成 SQL。

转置视图

转置视图交换行列，适合：

  • 单行但字段很多的记录
  • 并排查看字段类型、注释、默认值和可空状态
  • 对比少量记录的大字段

转置视图支持选择、复制、详情、编辑和导航。排序与数据库侧过滤仍以原始结果方向为准。

列格式化器

列格式化器只改变显示，不修改底层数据。常见选项包括：

  • 全局或列级日期/时间格式
  • JSON 路径提取
  • 值掩码
  • 自定义显示模板
  • 数字、布尔值和数据库类型对应的显示方式

如果需要恢复原始值，清除当前列格式化器即可。

选择、复制与导航

表格支持单元格、矩形区域、整行和多行选择。选择后可以：

  • 查看数量、求和等选择摘要（适用于可计算值）
  • 复制为 TSV、CSV、JSON、Markdown、SQL INSERT 或 UPDATE
  • 复制单元格、选中区域、整行或带表头结果
  • 选择列名引用方式，包括数据库标识符引号
  • 使用字段注释作为复制列名（适合面向业务的表格）
  • 为多行生成单条批量 INSERT，或逐行 INSERT
  • 排除主键后复制为新记录模板

当字段存在可识别外键关系时，可以从单元格跳转到被引用记录。这个入口依赖元数据和目标连接权限。

导出

格式适合场景
CSV / TSV电子表格、脚本和文本交换
JSONAPI 调试和程序处理
MarkdownIssue、PR、文档和聊天
XLSXExcel 交付；超出单工作表上限时会拆分工作表
SQL复用选中数据生成 INSERT 或 UPDATE

导出查询结果时，DBX 会按当前结果和选择范围处理。导出前确认当前页面、筛选、排序和选择区域，避免把“当前可见数据”误认为完整表。

自动刷新、分页与大结果集

  • 打开表时的分页大小可以配置并持久化
  • 自动刷新适合监控变化较快的小结果集
  • 查询执行结果可以保留多个运行记录或固定需要对比的结果
  • 大结果集只在可视区域渲染，但数据库查询和传输成本仍取决于实际返回行数
  • 排序、过滤或自动刷新会重新获取数据，未保存编辑可能阻止或影响刷新
自动刷新不适合正在编辑的数据，也不能替代监控系统。大表请先缩小查询范围，再提高刷新频率。

常见问题

现象检查项
结果只能查看不能编辑是否为 Join/聚合；是否有主键；连接是否只读；驱动是否支持编辑
过滤后行数没有减少使用的是客户端搜索/过滤，而不是数据库侧 WHERE
排序只影响当前页当前使用了本地排序；需要跨页稳定排序时改用 ORDER BY
粘贴后列错位剪贴板列数、当前选中起始列、隐藏列和字段顺序
图片或空间数据没有预览值格式、MIME/二进制类型、几何编码或 SRID 无法识别
导出数量和预期不同当前页、选择区域、客户端过滤和数据库查询范围

编写查询

使用补全、执行目标、多结果和查询历史生成数据表格。

批量导入

从 CSV、TSV、JSON 或 Excel 导入大量数据。

跨库传输

在不同连接或数据库引擎之间复制表数据。

保护生产写入

配置只读连接、生产确认和 MCP 权限。

查询编辑器

使用 DBX 编写、理解、参数化、执行、分析和复用 SQL。

结构浏览与对象树

使用 DBX 侧边栏组织连接、搜索数据库对象、打开数据与结构，并执行数据库专属操作。

本页目录

浏览与布局过滤、搜索与排序什么时候可以编辑编辑、新增与删除SQL 预览与保存单元格详情与复杂值预览转置视图列格式化器选择、复制与导航导出自动刷新、分页与大结果集常见问题