PostgreSQL 提供这些辅助函数来从事件触发器中检索信息。
关于事件触发器的更多信息， 请参见 Chapter 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 | 如果该命令是一个扩展脚本的一部分则为真 |
command | pg_ddl_command | 命令的完整表示，采用内部格式。它无法被直接输出，但可以把它传给其他函数以获取关于该命令的各类信息。 |
pg_event_trigger_dropped_objects() →setof record
pg_event_trigger_dropped_objects
返回由调用它的命令在其 sql_drop
事件中所删除的所有对象的列表。
如果在任何其他上下文中调用，则会抛出错误。
This function returns the following columns:
| 名称 | 类型 | 说明 |
|---|---|---|
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 9.111
中展示的函数提供关于刚被调用了一个
table_rewrite
事件的表的信息。
如果在任何其他上下文中调用，
会抛出一个错误。
Table 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();