2025年9月25日: PostgreSQL 18 发布!
支持版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3

9.30. 事件触发器函数 #

PostgreSQL 提供这些辅助函数来从事件触发器中检索信息。

有关事件触发器的更多信息,请参阅 第 38 章

9.30.1. 命令结束时捕获更改 #

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 命令的完整表示,采用内部格式。此项无法直接输出,但可以传递给其他函数以获取关于命令的不同信息。

9.30.2. 处理由 DDL 命令删除的对象 #

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_typeaddress_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.30.3. 处理表重写事件 #

表 9.111 中显示的函数提供了一个刚调用了 table_rewrite 事件的表的有关信息。如果在此其他上下文中调用,将引发错误。

表 9.111. 表重写信息函数

函数

描述

pg_event_trigger_table_rewrite_oid () → oid

返回即将重写的表的 OID。

pg_event_trigger_table_rewrite_reason () → integer

返回一个解释重写原因的代码。该值是根据以下值构建的位图:1(表已更改其持久性)、2(列的默认值已更改)、4(列具有新的数据类型)和 8(表访问方法已更改)。


可以使用这些函数在事件触发器中,如下所示

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();

提交更正

如果您在文档中发现任何不正确、与您对特定功能的体验不符或需要进一步澄清的内容,请使用 此表单 报告文档问题。