PostgreSQL中如何为指定schema下新建表自动添加表注释？

你之前尝试的写法是普通DML触发器的语法，这类触发器仅能绑定到具体表的增删改操作，不支持监听schema级的CREATE TABLE DDL事件。PostgreSQL 9.3及以上版本原生提供**事件触发器（Event Trigger）**能力，可直接监听库级别的DDL操作，完全可以实现新建表自动加注释的需求，无需依赖外部扩展。

实现步骤 #

1. 新建适配事件触发器的注释生成函数 #

该函数会自动从事件上下文提取新建表的schema、表名信息，过滤非目标schema的操作，同时做SQL安全转义，避免特殊字符、SQL注入问题：

CREATE OR REPLACE FUNCTION auto_add_table_comment()
RETURNS event_trigger 
LANGUAGE plpgsql
AS $$
DECLARE
  v_target_schema TEXT := TG_SCHEMA_NAME;
  v_target_table TEXT := TG_TABLE_NAME;
  v_comment_sql TEXT;
BEGIN
  -- 限定仅处理指定schema下的操作，将my_schema替换为你实际需要监听的schema名
  IF v_target_schema <> 'my_schema' THEN
    RETURN;
  END IF;

  -- 拼接带安全转义的注释SQL
  v_comment_sql := format(
    'COMMENT ON TABLE %I.%I IS %L',
    v_target_schema,
    v_target_table,
    format('Created by %s on %s', CURRENT_USER, CURRENT_TIMESTAMP)
  );

  EXECUTE v_comment_sql;
END;
$$;

2. 绑定事件触发器到DDL完成事件 #

由于需要等新表创建完成后再执行注释操作，因此将触发器绑定到ddl_command_end事件（DDL执行成功后触发），同时限定仅监听建表相关的操作：

CREATE EVENT TRIGGER my_schema_create_table_trigger
  ON ddl_command_end
  WHEN TAG IN ('CREATE TABLE', 'CREATE TABLE AS', 'CREATE PARTITIONED TABLE')
  EXECUTE FUNCTION auto_add_table_comment();

关键注意事项 #

• 不要使用ddl_command_start事件，该事件在DDL实际执行前触发，此时目标表还未创建，直接执行注释语句会报对象不存在的错误。
• 代码中使用format函数的%I自动转义标识符、%L自动转义字符串，避免表名包含大小写、空格、双引号等特殊字符时SQL执行失败，同时规避安全风险。
• 如果需要调整触发范围，比如只监听普通表、过滤临时表，可在函数判断逻辑中补充对应规则（比如通过TG_TABLE_NAME判断是否以pg_temp开头）。
• 事件触发器属于库级对象，创建操作需要超级用户权限。

触发器管理常用命令 #

-- 临时禁用触发器
ALTER EVENT TRIGGER my_schema_create_table_trigger DISABLE;
-- 重新启用触发器
ALTER EVENT TRIGGER my_schema_create_table_trigger ENABLE;
-- 彻底删除触发器
DROP EVENT TRIGGER my_schema_create_table_trigger;

内容的提问来源于stack exchange，提问作者JoeBe