PostgreSQL 提供这些辅助函数来从事件触发器中检索信息。
有关事件触发器的更多信息,请参阅 第 38 章。
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.111 中显示的函数提供了一个刚调用了 table_rewrite 事件的表的有关信息。如果在此其他上下文中调用,将引发错误。
表 9.111. 表重写信息函数
可以使用这些函数在事件触发器中,如下所示
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();