dbeaver 不展示注释

步骤一:新建驱动管理器(使用 OceanBase 专用驱动)

不要使用 DBeaver 自带的 OceanBase 驱动,需要手动添加 OceanBase 官方驱动。

获取驱动:

  • 通过 Maven 仓库下载
<dependency>
    <groupId>com.oceanbase</groupId>
    <artifactId>oceanbase-client</artifactId>
    <version>2.4.17</version> <!-- 请替换为最新版本号 -->
</dependency>

操作步骤:

  1. 打开 DBeaver,点击菜单 数据库 → 驱动管理器
  2. 点击 新建
  3. 填写以下信息:
配置项填写内容
驱动名称 OB-Oracle(可自定义)
驱动类型 Generic
类名 com.alipay.oceanbase.jdbc.Driver
URL 模板 jdbc:oceanbase:oracle://{host}:{port}/{database}
  1. 切换到 库 标签页,点击 添加文件,上传 OceanBase 的 JDBC 驱动包(如 oceanbase-client-2.4.x.jar)
  2. 点击 确定 保存

注意:{database} 部分建议填上你的租户名,否则 SQL 编写时不会有表名/字段名提示。

步骤二:配置驱动属性(关键步骤)

这一步是让驱动“返回注释”的核心配置。

操作步骤:

  1. 右键点击你的 OceanBase 连接 → 编辑连接
  2. 切换到 驱动属性 标签页
  3. 添加/修改以下属性(注意大小写敏感):
属性名值作用
remarksReporting true 核心:让驱动返回注释
useInformationSchema true 使用 INFORMATION_SCHEMA 获取元数据
nullCatalogMeansCurrent true 限定当前数据库范围
  1. 点击 确定 保存
  2. 断开连接后重新连接,使配置生效

步骤三:开启 DBeaver 全局显示注释

操作步骤:

  1. 菜单 窗口 → 首选项 → 编辑器 → 数据编辑器 → 外观
  2. 勾选 在标题栏显示列描述
  3. 点击 应用并关闭,重启 DBeaver

🔥 一步到位:给 OB 驱动设置全局默认参数

  1. 打开驱动管理器
    顶部菜单:数据库 → 驱动管理器 → 找到你用的 OceanBase / MySQL 驱动
  2. 进入驱动属性
    点右上角 属性(Properties) 切换到驱动属性(Driver properties) 标签
  3. 添加这 3 个全局默认值
属性名值作用
remarksReporting true 核心:让驱动返回注释 :读取字段注释
useInformationSchema true 使用 INFORMATION_SCHEMA 获取元数据:读取表结构、注释
nullCatalogMeansCurrent true 限定当前数据库范围:解决表找不到爆红

添加方法:

  • 点 添加
  • 输入属性名称
  • 值设为 true
  • 确定
  1. 最重要一步:点 确定 ← 必须保存
    然后重启 DBeaver(可以先尝试先断开连接再重新连接)
  2. 查询的时候需要带上SCHEMA,并且表名、库名不能忽略大小写
    SELECT * FROM ACCT       → 不显示字段描述
    SELECT * FROM schema.ACCT    → 不显示字段描述
    SELECT * FROM SCHEMA.acct    → 不显示字段描述
    SELECT * FROM SCHEMA.ACCT   → 正常显示字段描述。
posted @ 2026-06-01 20:34  zhangpba  阅读(202)  评论(0)    收藏  举报