开发快照。 PostgreSQL 20devel 尚未正式发布，内容仍可能变化。
9.31. 事件触发器函数 #
PostgreSQL 提供了这些辅助函数来从事件触发器检索信息。
更多有关事件触发器的信息请见第 38 章。
9.31.1. 在命令结束时捕捉更改 #
pg_event_trigger_ddl_commands() →setof record
当在一个 ddl_command_end 事件触发器的函数中调用时，pg_event_trigger_ddl_commands 返回被每一个用户动作执行的 DDL 命令的列表。如果在其他任何环境中调用这个函数，会发生错误。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 | 命令的完整内部表示，不能直接输出，但可以将其传给其他函数以获取关于该命令的不同信息。 |
9.31.2. 处理被 DDL 命令删除的对象 #
pg_event_trigger_dropped_objects() →setof record
在命令的 sql_drop 事件中调用 pg_event_trigger_dropped_objects 时，它返回该命令删除的所有对象的列表。如果调用在任何其他上下文中，会引发一个错误。这个函数返回以下列：
| 名称 | 类型 | 描述 |
|---|---|---|
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();
9.31.3. 处理表重写事件 #
表 9.114 中所示的函数提供有关刚刚为其触发 table_rewrite 事件的表的信息。如果在任何其他环境中调用，会发生错误。
表 9.114. 表重写信息函数
这些函数可以在事件触发器中使用，就像这样：
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();