DBeaver如何切换为列模式显示表结构？

Question

在使用DBeaver查看数据库表结构时，用户常遇到默认以行模式（Row Mode）展示字段信息的问题，导致无法直观对比多个字段的属性。许多开发者希望切换为列模式（Column Mode），以便垂直查看所有字段的名称、类型、是否为空等元数据。然而，DBeaver界面中并未提供明显的“切换列模式”按钮，导致用户困惑如何调整视图布局。常见疑问包括：在哪里找到列模式选项？是否需要修改结果集显示设置？该功能是否依赖特定数据库类型或DBeaver版本？如何持久化保存此视图偏好？

Answer 1

1. 问题背景与常见困惑

在使用 DBeaver 查看数据库表结构时，用户默认进入的是“行模式”（Row Mode）展示字段信息。这种布局将每个字段的属性（如名称、类型、是否为空等）以横向记录的形式逐条列出，导致难以进行跨字段的属性对比。

许多具有5年以上开发经验的工程师反馈：当需要快速评估表设计合理性、检查索引策略或对比多个字段的数据类型一致性时，行模式显得效率低下。他们期望切换至“列模式”（Column Mode），即所有字段作为列标题，属性作为行内容垂直排列，从而实现一屏内全局审视元数据。

然而，DBeaver 并未在界面中提供显式的“切换为列模式”按钮，这引发了如下典型疑问：

• 列模式选项究竟隐藏在哪一个菜单路径下？
• 是否需要调整结果集显示设置（Result Set Presentation）来实现？
• 该功能是否仅适用于某些数据库类型（如 PostgreSQL 或 MySQL）？
• 不同版本的 DBeaver（如 21.x vs 23.x vs 最新 24.x）对此支持是否存在差异？
• 如何保存此视图偏好，使其在重启后依然生效？

2. 技术原理分析：DBeaver 元数据展示机制

DBeaver 的表结构查看功能主要依赖于其“元数据浏览器”（Metadata Browser）组件，该组件通过 JDBC 驱动从数据库系统表（如 INFORMATION_SCHEMA.COLUMNS）提取字段定义，并交由 UI 层渲染。

默认情况下，DBeaver 使用“实体-属性-值”（Entity-Attribute-Value, EAV）模型组织数据显示，因此采用行模式呈现单个字段的所有属性。这种设计利于查看单字段详情，但不利于横向比较。

而所谓的“列模式”，实际上是 UI 布局的一种转置操作 —— 将原本按字段分组的数据显示方式，转换为按属性分类、字段作为维度展开的表格形式。

关键点在于：这一功能并非直接称为“Column Mode”，而是集成在“结果集显示模式”的高级选项中，且受制于当前面板类型（如“Properties” vs “Data” 视图）。

以下为影响视图展示的核心因素：

影响因素	说明	是否可配置
结果集呈现方式	决定是表格还是树形/行模式显示	是（可通过右键菜单切换）
数据库连接类型	部分数据库驱动限制元数据获取粒度	否（仅读取能力受限）
DBeaver 版本	23.0+ 引入了更灵活的元数据显示选项	是（推荐使用 23.1.5 及以上）
用户首选项设置	全局控制结果集默认行为	是（Window → Preferences）

3. 解决方案路径详解

要实现从默认行模式切换到类“列模式”的垂直对比视图，需遵循以下步骤：

1. 定位正确视图区域：打开目标表后，在左侧对象浏览器中选择该表，然后点击上方标签页中的 “Properties” 或 “Columns” 子项。
2. 调出结果集上下文菜单：在字段列表区域任意位置右键单击，弹出快捷菜单。
3. 切换显示模式：选择 “Presentation” → “Flat” 或 “Grid” 模式（具体名称依版本略有不同），部分版本提供 “Switch to Column-Oriented View” 选项。
4. 启用转置显示（Transpose View）：若存在 “Transpose” 选项，则勾选之，此时字段名将成为列头，属性成为行标签。
5. 验证是否成功：观察界面是否变为属性在左、字段横向排列的矩阵式布局。

示例操作流程图如下：

// 示例 SQL 查询用于辅助理解元数据来源
SELECT 
    COLUMN_NAME,
    DATA_TYPE,
    IS_NULLABLE,
    COLUMN_DEFAULT,
    CHARACTER_MAXIMUM_LENGTH,
    NUMERIC_PRECISION,
    NUMERIC_SCALE,
    COLUMN_KEY
FROM INFORMATION_SCHEMA.COLUMNS 
WHERE TABLE_NAME = 'your_table' AND TABLE_SCHEMA = 'your_db';

graph TD A[打开DBeaver并连接数据库] --> B[导航至目标表] B --> C[点击Properties或Columns标签页] C --> D[右键字段列表区域] D --> E[选择Presentation菜单] E --> F{是否有Transpose选项?} F -- 是 --> G[启用Transpose View] F -- 否 --> H[检查DBeaver版本或更换显示模式] G --> I[确认字段属性已垂直对齐展示] H --> I

4. 高级配置与持久化设置

为了确保每次打开表结构时自动进入理想的列导向视图，必须进行全局偏好设置：

进入菜单栏：Window → Preferences → Editors → Data Editor → Presentation，在此处可以设置：

• 默认结果集模式为 “Grid” 而非 “Form”
• 启用 “Automatically transpose small result sets”
• 设定触发转置的最大行数（例如 ≤ 50 行）

此外，DBeaver 支持工作区级别的视图记忆功能。只要不清理缓存或重置 UI 状态，已应用的转置视图将在下次打开同一对象时保留。

对于团队协作环境，建议将以下配置导出为共享设置：

eclipse.preferences.version=1
org.jkiss.dbeaver.data.presentation.grid.layout=FLAT
org.jkiss.dbeaver.data.presentation.auto-transpose=true
org.jkiss.dbeaver.data.presentation.transpose-threshold=50

这些参数可嵌入到项目级的 .dbeaver/workspace-settings.xml 文件中，实现团队统一的元数据浏览体验。