9.28. 事件触发器函数

9.28. 事件触发器函数
上一页	上一级	第 9 章函数和操作符	起始页	下一页

9.28.1. 捕获命令结尾的改变
9.28.2. 通过DDL命令删除处理的对象
9.28.3. 处理表重写事件

PostgreSQL提供这些帮助函数用以从事件触发器中检索信息。

关于事件触发器的更多信息，参见第 39 章。

9.28.1. 捕获命令结尾的改变

pg_event_trigger_ddl_commands返回通过每个用户操作执行的DDL命令列表，当调用函数中ddl_command_end事件触发器，如果在任何其它上下文中调用，则抛出一个错误。 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`	`bool`	命令是否是扩展脚本的一部分
`command`	`pg_ddl_command`	内部格式中命令的完整表示。这不能直接输出，但它可以传递给其它函数用来获取该命令的不同信息。

9.28.2. 通过DDL命令删除处理的对象

pg_event_trigger_dropped_objects返回其sql_drop事件中命令所删除的所有对象的列表。如果在任何其他环境中被调用，pg_event_trigger_dropped_objects将抛出一个错误。pg_event_trigger_dropped_objects返回下列列：

名称	类型	描述
`classid`	`Oid`	对象所属的目录的 OID
`objid`	`Oid`	在目录中的对象的 OID
`objsubid`	`int32`	对象的子ID（如列的属性号）
`original`	`bool`	用于标识删除的根对象的标志
`normal`	`bool`	标志表明在导致这个对象的依赖关系图中有一个正常的依赖关系
`is_temporary`	`bool`	标志表明该对象是临时对象。
`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 PROCEDURE test_event_trigger_for_drops();

9.28.3. 处理表重写事件

显示在表 9.90中的函数提供关于表的信息，其中table_rewrite事件刚刚被调用。如果在任何其它上下文中调用，则抛出错误。

表 9.90. 表重写信息

名称	返回类型	描述
`pg_event_trigger_table_rewrite_oid()`	`Oid`	关于被改写的表的OID。
`pg_event_trigger_table_rewrite_reason()`	`int`	原因代码解释重写的原因。代码的确切意义是释放依赖。

在下面这样的事件触发器中使用pg_event_trigger_table_rewrite_oid函数：

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 PROCEDURE test_event_trigger_table_rewrite_oid();