看起来你已经尝试给PostgreSQL的表和字段添加注释，但查询时拿不到预期结果，我来帮你一步步排查可能的问题：

1. 先确认注释是否真的成功写入数据库 #

有时候执行语句显示“成功”，但实际可能因为各种小问题没生效，你可以用PostgreSQL自带的工具快速验证：

• 打开psql命令行客户端，连接到你的数据库，执行 \d+ statements，这个命令会直接显示表的结构，包括每个字段的注释，一眼就能看出注释有没有加上。
• 或者用另一个更可靠的查询语句从系统表读取：

  SELECT 
      c.table_name,
      c.column_name,
      pgd.description AS column_comment
  FROM 
      pg_catalog.pg_statio_all_tables AS st
      JOIN pg_catalog.pg_description pgd ON pgd.objoid = st.relid
      JOIN information_schema.columns c 
          ON pgd.objsubid = c.ordinal_position 
          AND c.table_schema = st.schemaname 
          AND c.table_name = st.relname 
          AND c.column_name = (SELECT attname FROM pg_attribute WHERE attrelid = st.relid AND attnum = pgd.objsubid)
  WHERE 
      c.table_schema = 'public' 
      AND c.table_name = 'statements';
  

  这个查询直接从PostgreSQL的核心系统表pg_description取数据，比col_description函数的方式更直接，试试能不能拿到注释。

2. 检查你当前查询语句的潜在问题 #

你用的col_description函数查询，理论上是正确的，但可以试试两个小调整：

• 把表名直接拼接成完整的regclass字符串，比如替换成 col_description('public.statements'::regclass, ordinal_position)，避免字符串拼接时的潜在问题；
• 确认information_schema.columns里的ordinal_position和字段的实际顺序一致，不过这个一般不会出问题，但可以对比\d+的结果验证。

3. 排查SQLAlchemy执行注释语句的问题 #

看你的Python代码，是按分号分割SQL文件里的语句执行的，这里可能有几个坑：

• 语句分割问题：如果你的SQL文件里的注释语句前后有多余的空行、注释内容，可能导致分割后的语句不完整。可以检查执行日志里打印的Executing query:内容，看看是不是完整的COMMENT语句；
• 事务提交问题：PostgreSQL的DDL语句默认是在事务里的，虽然SQLAlchemy的connect()上下文管理器会自动提交，但有时候特殊情况可能没提交。你可以试试在执行完每个COMMENT语句后，手动加上connection.commit()，或者把引擎设置成autocommit=True；
• 验证执行日志：把SQLAlchemy的引擎打开echo模式，比如create_engine(connection_string, echo=True)，这样能看到实际发送到数据库的SQL语句，确认COMMENT语句是不是真的正确执行了。

4. 关于user_col_comments的报错 #

那个视图是Oracle数据库里的，PostgreSQL根本没有这个系统表，所以报错是正常的，别再用那个方法啦。

备注：内容来源于stack exchange，提问作者Kundan