MySQL不支持单条ALTER TABLE批量修改多表注释，必须逐表执行ALTER TABLE ... COMMENT语句；可通过information_schema查询拼接或shell脚本自动执行；PostgreSQL需用DO块配合quote_ident动态执行。
MySQL 里 ALTER TABLE 不支持批量改表注释
直接用一条 ALTER TABLE 无法同时给多张表加或改注释——它只作用于单表。想“批量”，本质是生成并执行多条独立的 ALTER TABLE ... COMMENT = 'xxx' 语句。
常见错误现象：ERROR 1064 (42000): You have an error in your SQL syntax，往往是因为把多个表名塞进一个 ALTER TABLE 语句里，比如 ALTER TABLE t1, t2 COMMENT = 'xxx'，这在 MySQL 中非法。
- 必须逐表执行，不能靠语法糖“一次写完”
- 表名需明确列出，或通过查询
information_schema.tables动态获取 - 如果表名含特殊字符（如横线、空格），记得用反引号包裹：
`my-table`
用 SELECT CONCAT() 自动生成批量修改语句
最常用、最可控的方式：查出目标表名，拼出对应的 ALTER TABLE 语句，复制执行或导出为 SQL 文件运行。
例如，给当前库中所有以 log_ 开头的表统一加注释：
SELECT CONCAT('ALTER TABLE `', table_name, '` COMMENT = "日志表";')
FROM information_schema.tables
WHERE table_schema = DATABASE()
AND table_name LIKE 'log_%';
执行后会输出一串 ALTER TABLE 语句，复制粘贴到客户端执行即可。
-
DATABASE()返回当前数据库名；若要指定库，直接写死字符串，如'my_app' - 注意
CONCAT()拼接时别漏空格和分号，否则生成的语句语法错误 - 生成结果不含事务控制，建议手动加
BEGIN; ... COMMIT;包裹，避免中途失败导致部分生效
用 shell 脚本 + mysql -e 实现真·自动执行
如果不想手动复制粘贴，可以用 shell 脚本把生成和执行两步串起来。适合运维或 CI/CD 场景。
示例（假设目标库叫 prod_db）：
mysql -Nse "SELECT table_name FROM information_schema.tables WHERE table_schema='prod_db' AND table_name LIKE 'config%'" prod_db | \ while read tbl; do mysql prod_db -e "ALTER TABLE \`$tbl\` COMMENT = '配置相关表';" done
关键点：
-
-N去掉列名头，-s精简输出，避免干扰解析 - 表名变量
$tbl必须用反引号包裹，防止含特殊字符时报错 - 每条
ALTER TABLE单独执行，失败不会中断后续；如需强一致性，得加set -e或检查$? - 大量表时性能无压力，但注意连接数限制，可加
--connect-timeout=5
PostgreSQL 怎么办？语法完全不同
PostgreSQL 没有 COMMENT ON TABLE ... IS 的批量写法，也不能用 CONCAT() 拼 DDL。必须用 DO $$ ... $$ 块动态执行。
例如，给 public schema 下所有表加注释：
DO $$
DECLARE r RECORD;
BEGIN
FOR r IN SELECT tablename FROM pg_tables WHERE schemaname = 'public' LOOP
EXECUTE 'COMMENT ON TABLE public.' || quote_ident(r.tablename) || ' IS ''业务主表''';
END LOOP;
END $$;
注意点：
-
quote_ident()是必须的，防止表名注入或含大小写/特殊字符时报错 - 不能在普通 SQL 客户端里直接粘贴执行，需用
psql或支持匿名代码块的工具 - 不支持跨 schema 批量操作，
schemaname条件要写清楚
真正麻烦的不是写法，而是注释内容是否准确、是否与字段注释保持一致。很多团队改完表注释，忘了同步更新文档或 ORM 模型里的 docstring，过两个月自己都看不懂那句“基础支撑表”到底指啥。
