9.28. 事件触发器函数
PostgreSQL提供这些帮助函数用以从事件触发器中检索信息。
关于事件触发器的更多信息,参见第 38 章。
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-88中的函数提供关于表的信息, 其中table_rewrite事件刚刚被调用。如果在任何其它上下文中调用,则抛出错误。
表 9-88. 表重写信息
名称 | 返回类型 | 描述 |
---|---|---|
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();