2024年9月26日:PostgreSQL 17 发布!
支持的版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不受支持的版本: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 整数 子对象ID(例如,列的属性编号)
command_tag 文本 命令标签
object_type 文本 对象的类型
schema_name 文本 对象所属的模式的名称(如果有);否则为NULL。不应用引号。
object_identity 文本 对象标识的文本呈现,模式限定。如果需要,标识中包含的每个标识符都会被引用。
in_extension 布尔值 如果命令是扩展脚本的一部分,则为真
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 整数 子对象ID(例如,列的属性编号)
original 布尔值 如果这是删除操作的根对象之一,则为真
normal 布尔值 如果依赖关系图中存在导致此对象的正常依赖关系,则为真
is_temporary 布尔值 如果这是一个临时对象,则为真
object_type 文本 对象的类型
schema_name 文本 对象所属的模式的名称(如果有);否则为NULL。不应用引号。
object_name 文本 对象的名称,如果模式和名称的组合可以用作对象的唯一标识符;否则为NULL。不应用引号,并且名称永远不会是模式限定的。
object_identity 文本 对象标识的文本呈现,模式限定。如果需要,标识中包含的每个标识符都会被引用。
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.108中显示的函数提供了有关刚刚调用table_rewrite事件的表的信息。如果在任何其他上下文中调用,则会引发错误。

表9.108. 表重写信息函数

函数

描述

pg_event_trigger_table_rewrite_oid () → oid

返回要重写的表的OID。

pg_event_trigger_table_rewrite_reason () → integer

返回一个代码,解释重写的原因。代码的确切含义取决于版本。


这些函数可以像这样在事件触发器中使用

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

提交更正

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