建站实战干货

Oracle 连接驱动属性快速配置清单

Oracle 在 DBeaver 里默认不显示字段注释，是因为 Oracle JDBC 驱动默认不返回注释元数据，需要额外配置才能开启。下面是完整的设置步骤：

一、先开启全局显示注释（已做可跳过）

1. 菜单：Window → Preferences → Editors → Data Editor → Appearance

2. 勾选：Show column description in header（在标题栏显示列描述）

3. 应用并关闭，重启 DBeaver

---

二、关键：Oracle 连接驱动属性配置（必须做）

1. 右键 Oracle 连接 → Edit Connection（编辑连接）

2. 切换到 Driver properties（驱动属性） 标签页

3. 添加 / 修改以下 3 个属性（大小写敏感）：

属性名	值	作用
oracle.jdbc.useRemarks	true	启用注释元数据（核心）
oracle.jdbc.useColumnNamesInMetadata	false	优先返回注释而非纯字段名
oracle.jdbc.includeSynonyms	true	可选，支持同义词

1. 保存 → 断开并重新连接 Oracle

---

三、验证与排查

1. 执行查询，表头应显示：字段名 - 注释

2. 若仍不显示：

• 检查用户权限：需能查询 ALL_COL_COMMENTS / USER_COL_COMMENTS

• 用 SQL 确认注释存在：

SELECT COLUMN\_NAME, COMMENTS FROM USER\_COL\_COMMENTS WHERE TABLE\_NAME = '你的表名';

1. 若还是不行：更新 Oracle JDBC 驱动到最新版

---

四、临时显示（不修改连接）

• 结果集右键列标题 → Show → Column Comments

• 或鼠标悬停列标题，看提示是否显示注释