PostgreSQL事件触发器函数用于捕捉DDL删除对象与表重写-云原生数据库 PolarDB-阿里云

本文介绍了PolarDB PostgreSQL版（兼容Oracle）支持事件触发器函数。

在命令结束处捕捉更改

    pg_event_trigger_ddl_commands () → setof record

当在一个ddl_command_end事件触发器的函数中调用时， pg_event_trigger_ddl_commands返回被每一个用户动作执行的DDL命令的列表。如果在其他任何环境中调用这个函数，会发生错误。 pg_event_trigger_ddl_commands为每一个被执行的基本命令返回一行，某些只有一个单一SQL句子的命令可能会返回多于一行。这个函数返回下面的列：

名称	类型	描述
`classid`	`oid`	对象所属的目录的OID。
`objid`	`oid`	对象本身的OID。
`objsubid`	`integer`	对象的子-id（例如列的属性号）。
`command_tag`	`text`	命令标签。
`object_type`	`text`	对象的类型。
`schema_name`	`text`	该对象所属的模式的名称（如果有），如果没有则为`NULL`。没有引号。
`object_identity`	`text`	对象标识的文本表现形式，用模式限定。如果必要，出现在该标识中的每一个标识符都会被引用。
`in_extension`	`boolean`	如果该命令是一个扩展脚本的一部分则为真。
`command`	`pg_ddl_command`	以内部格式表达的该命令的一个完整表现形式。这不能被直接输出，但是可以把它传递给其他函数来得到有关于该命令不同部分的信息。

处理被DDL命令删除的对象

    pg_event_trigger_dropped_objects () → setof record

pg_event_trigger_dropped_objects返回被调用sql_drop事件的命令删除的所有对象的列表。如果调用在任何其他上下文中，会引发一个错误。这个函数返回以下列：

名称	类型	描述
`classid`	`oid`	对象所属的目录的OID。
`objid`	`oid`	对象本身的OID。
`objsubid`	`integer`	子对象ID（如列的属性号）。
`original`	`boolean`	如果这是删除中的一个根对象则为真。
`normal`	`boolean`	指示在依赖图中有一个普通依赖关系指向该对象的标志。
`is_temporary`	`boolean`	如果该对象是一个临时对象则为真。
`object_type`	`text`	对象的类型。
`schema_name`	`text`	对象所属模式的名称（如果存在）；否则为`NULL`。不应用引用。
`object_name`	`text`	如果模式和名称的组合能被用于对象的一个唯一标识符，则是对象的名称；否则是`NULL`。不应用引用，并且名称不是模式限定的。
`object_identity`	`text`	对象身份的文本表现，模式限定的。每一个以及所有身份中出现的标识符在必要时加引号。
`address_names`	`text[]`	一个数组，它可以和`object_type`及`address_args`，一起通过`pg_get_object_address`函数在一台包含有同类相同名称对象的远程服务器上重建该对象地址。
`address_args`	`text[]`	上述`address_names`的补充。

pg_event_trigger_dropped_objects可以被这样用在一个事件触发器中：

    CREATE FUNCTION test_event_trigger_for_drops()
            RETURNS event_trigger LANGUAGE plpgsql AS $$
    DECLARE
        obj record;
    BEGIN
        FOR obj IN SELECT * FROM pg_event_trigger_dropped_objects()
        LOOP
            RAISE NOTICE '% dropped object: % %.% %',
                         tg_tag,
                         obj.object_type,
                         obj.schema_name,
                         obj.object_name,
                         obj.object_identity;
        END LOOP;
    END;
    $$;
    CREATE EVENT TRIGGER test_event_trigger_for_drops
       ON sql_drop
       EXECUTE FUNCTION test_event_trigger_for_drops();

处理表重写事件

表重写信息函数表中所示的函数提供刚刚被调用过 table_rewrite 事件的表的信息。如果在任何其他环境中调用，会发生错误。

表重写信息函

pg_event_trigger_table_rewrite_oid () → oid

返回将要重写的表的OID。

pg_event_trigger_table_rewrite_reason () → integer

返回解释重写因的代码。代码的确切含义取决于版本。

这些函数可以在事件触发器中使用，就像这样:

    CREATE FUNCTION test_event_trigger_table_rewrite_oid()
     RETURNS event_trigger
     LANGUAGE plpgsql AS
    $$
    BEGIN
      RAISE NOTICE 'rewriting table % for reason %',
                    pg_event_trigger_table_rewrite_oid()::regclass,
                    pg_event_trigger_table_rewrite_reason();
    END;
    $$;

    CREATE EVENT TRIGGER test_table_rewrite_oid
                      ON table_rewrite
       EXECUTE FUNCTION test_event_trigger_table_rewrite_oid();