选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3
历史版本PostgreSQL 9.5 已于 2021 年 2 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本

9.28. 事件触发器函数 #

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

更多有关事件触发器的信息请见第 37 章

9.28.1. 在命令结束处捕捉更改 #

当在一个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 bool 如果该命令是一个扩展脚本的一部分则为真
command pg_ddl_command 命令的完整内部表示,不能直接输出,但可以将其传给其他函数以获取关于该命令的不同信息。

9.28.2. 处理被 DDL 命令删除的对象 #

在命令的 sql_drop 事件中调用 pg_event_trigger_dropped_objects 时,它返回该命令删除的所有对象的列表。如果在其他上下文中调用,pg_event_trigger_dropped_objects 会报错。pg_event_trigger_dropped_objects 返回以下列:

名称 类型 描述
classid oid 对象原先所属系统目录的 OID
objid oid 对象本身的 OID
objsubid integer 子对象 ID(例如列的属性编号)
original bool 如果这是删除中的一个根对象则为真
normal bool 如果依赖图中存在指向该对象的普通依赖关系,则为真。
is_temporary bool 如果该对象是一个临时对象则为真
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 PROCEDURE test_event_trigger_for_drops();

9.28.3. 处理表重写事件 #

表 9.78 中所示的函数提供刚刚被调用过table_rewrite 事件的表的信息。如果在任何其他环境中调用,会发生错误。

表 9.78. 表重写信息

名称 返回类型 描述
pg_event_trigger_table_rewrite_oid() Oid 即将重写的表的 OID。
pg_event_trigger_table_rewrite_reason() int 解释重写原因的原因代码。代码的确切含义取决于版本。

pg_event_trigger_table_rewrite_oid函数可以按如下方式用于事件触发器:

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

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。