MySQL表注释需用ALTER TABLE表名 COMMENT='注释'语句添加,DBeaver仅执行并显示,不提供图形化按钮;执行后须刷新表节点、启用“显示对象描述”且连接参数含useUnicode=true&characterEncoding=UTF-8方可正常显示中文注释。

直接在数据库里加,DBeaver 本身不提供“给表加注释”的图形化按钮——它只是读取和展示元数据,不是注释的源头。
MySQL 表注释:用 ALTER TABLE + COMMENT
MySQL 的表注释必须通过 SQL 命令写入系统表,DBeaver 只负责执行和后续显示:
-
ALTER TABLE 表名 COMMENT = '这里是表的中文注释';是标准写法(注意等号可选,但加了更明确) - 执行后需刷新表节点(右键 → “刷新” 或 F5),否则导航树里看不到变化
- 如果注释含中文却显示为
???,大概率是 JDBC 连接参数缺了useUnicode=true&characterEncoding=UTF-8 - 表注释生效后,在 DBeaver 导航树中要配合开启「显示对象描述」才能看到
表名(注释)格式
Oracle / PostgreSQL 表注释:COMMENT ON TABLE
这两类数据库语法统一,且注释会持久存于数据字典中,DBeaver 能直接读取:
- Oracle:
COMMENT ON TABLE 表名 IS '用户信息主表'; - PostgreSQL:
COMMENT ON TABLE 表名 IS '用户信息主表'; - 执行成功后无需重启连接,但同样要确保「显示对象描述」已启用,否则导航树不显示括号内容
- 注意:Oracle 中表名默认大写,
COMMENT ON TABLE USER_INFO IS ...比user_info更稳妥
DBeaver 不显示表注释?先查这三处
即使 SQL 执行成功,DBeaver 仍不显示注释,问题通常出在配置层或元数据层面:
- 「窗口 → 首选项 → 用户界面 → 导航 → 显示对象描述」没勾选 → 导航树永远只显示纯表名
- 连接配置里没开元数据读取:MySQL 需确认 URL 含
useInformationSchema=true;Oracle/PG 一般默认支持,但旧驱动可能需要升级 - 执行了注释语句但没提交:Oracle 默认非自动提交,忘记
COMMIT;就白写了;PostgreSQL 在单条语句下自动生效,MySQL 则取决于存储引擎(InnoDB 支持事务,MyISAM 不支持)
真正容易被忽略的是:表注释和字段注释是两套独立机制,开了「显示对象描述」只管表名后的括号,不管查询结果列头——后者得另外开「在标题栏中显示列描述」。两者缺一不可,但作用范围完全不同。










