PostgreSQL 提供了这些帮助函数来从事件触发器中检索信息。
有关事件触发器的更多信息,请参阅 第 40 章。
pg_event_trigger_ddl_commands
() →setof record
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 |
boolean |
如果命令是扩展脚本的一部分,则为 True |
command |
pg_ddl_command |
命令的完整表示,采用内部格式。这不能直接输出,但可以传递给其他函数以获取有关命令的不同信息。 |
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 |
如果这是删除的根对象之一,则为 True |
normal |
boolean |
如果在导致此对象的依赖关系图中存在正常依赖关系,则为 True |
is_temporary |
boolean |
如果这是临时对象,则为 True |
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();
表 9.104 中显示的函数提供有关表的信息,该表刚刚调用了 table_rewrite
事件。如果在任何其他上下文中调用,则会引发错误。
表 9.104. 表重写信息函数
这些函数可用于事件触发器,如下所示
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();