MySQL需用ALTER/CREATE语句加注释，不支持批量；PostgreSQL用COMMENT ON TABLE/COLUMN IS语法，需拼SQL脚本生成，注意大小写、引号、权限及工具缓存。
MySQL 用 COMMENT 批量加表注释和字段注释
直接改 information_schema 不行，必须走 alter table 或 create table 语句。mysql 不支持一次性给多张表加注释，也没有内置批量注释命令，得靠脚本生成 sql。
常见错误是把注释写在建表语句末尾、或当成字段默认值处理，比如误写成 name VARCHAR(32) DEFAULT '用户姓名' COMMENT '用户名' —— 这里 COMMENT 是合法的，但只作用于该字段；而表级注释必须单独跟在 CREATE TABLE ... 后面，像这样：COMMENT='用户基础信息表'。
- 字段注释加在列定义末尾，多个字段可一起写，不影响性能
- 表注释只能出现一次，且必须放在整条
CREATE TABLE语句最后（括号外） - 如果表已存在，用
ALTER TABLE t1 COMMENT='xxx'修改表注释；字段注释需用MODIFY COLUMN或CHANGE COLUMN重申整个字段定义，不能只改COMMENT - 注意字符集：注释内容若含中文，确保连接字符集（如
utf8mb4）和表字符集一致，否则可能存成乱码或截断
PostgreSQL 怎么给已有表和字段批量加 COMMENT ON
PostgreSQL 的注释机制更正交：表、字段、索引、视图都用 COMMENT ON，语法统一，也支持批量执行，但不支持单条语句注释多个对象。
典型翻车点是漏写 IS 关键字，比如写成 COMMENT ON TABLE users '用户表'; —— 报错 syntax error at or near "users"；正确写法必须是 COMMENT ON TABLE users IS '用户表';。
- 字段注释要带完整路径：
COMMENT ON COLUMN users.name IS '用户名';，不能省略COLUMN和表名 - 想批量处理，得拼 SQL：从
pg_tables和pg_attribute查出目标对象，用SELECT 'COMMENT ON ...' || ...生成语句，再执行 - 注释内容为空字符串
''是合法的，等价于删除注释；但写NULL会报错 - 注释不参与查询优化，也不影响存储体积，但会影响
d+和 pgAdmin 等工具的显示
用 Python 脚本自动生成注释 SQL（适配 MySQL / PG）
人工写几百条 COMMENT 易错且不可维护，实际项目中建议用脚本读取 Excel 或 YAML 配置，按规则生成 SQL 文件。关键不是“怎么循环”，而是“怎么对齐元数据”。
容易忽略的是字段名大小写敏感性：MySQL 在 Windows 上不区分，Linux 上区分；PostgreSQL 默认转小写，除非用双引号包裹。如果配置里写了 "UserName"，生成 SQL 时就得保留双引号，否则注释会挂到不存在的字段上。
- 先确认目标库的标识符规则，再设计配置文件字段名格式（推荐全小写 + 下划线）
- 用
sqlparse或简单字符串模板生成 SQL，避免手拼引号嵌套出错 - 生成前务必加预检查：查表是否存在、字段是否拼错、注释长度是否超限（MySQL 表注释上限 2048 字符，字段注释 1024）
- 执行前导出备份语句，例如
SHOW CREATE TABLE t1;，防止误覆盖原定义
注释同步不到 ER 图或文档生成工具？检查这三点
很多团队加了注释却没出现在 PowerDesigner、dbdiagram.io 或 Sphinx 文档里，问题通常不出在注释本身，而出在工具链对接上。
最常被跳过的一步：PostgreSQL 需要显式开启 pg_catalog 权限才能让外部工具读取注释；MySQL 则要求连接用户有 SELECT 权限访问 information_schema.TABLES 和 COLUMNS 表。
- 确认工具使用的连接账号能查到
pg_description（PG）或information_schema.COLUMNS.COLUMN_COMMENT（MySQL） - 某些工具缓存元数据，加完注释后需手动刷新或清空本地缓存目录
- 字段注释若含换行符
\n字面量
IS，整批注释就静默失效——这种问题不会报错，只会让你在下游工具里反复怀疑人生。 
