Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17

9.30. 事件触发器函数 #

9.30.1. 捕获在命令结束处发生的更改
9.30.2. 处理 DDL 命令删除的对象
9.30.3. 处理表重写事件

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 布尔值 如果命令是扩展脚本的一部分,则为 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 整型 子对象 ID(例如,列的属性编号)
original 布尔值 如果这是删除的根对象之一,则为 True
normal 布尔值 如果导致这个对象的依赖图中出现了正常依赖关系,则为 True
is_temporary 布尔值 如果这是一个临时对象,则为 True
object_type 文本 对象的类型
schema_name 文本 对象所属架构的名称(如果存在);否则,为 NULL。不应用引号。
object_name 文本 对象名称,如果架构与名称的组合可用于作为对象的唯一标识符,则为 True;否则,为 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

返回说明重写原因的代码。该值是由下列值构成的位图: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();