PostgreSQL 教程

Appearance

9.29. 事件触发器函数# ​

9.29.1. 在命令结束时捕获更改
9.29.2. 处理 DDL 命令删除的对象
9.29.3. 处理表重写事件

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

有关事件触发器的更多信息，请参阅第 40 章。

9.29.1. 在命令结束时捕获更改# ​

pg_event_trigger_ddl_commands () → setof record

pg_event_trigger_ddl_commands返回由每个用户操作执行的DDL命令列表，当在附加到ddl_command_end事件触发器的函数中调用时。如果在任何其他上下文中调用，则会引发错误。pg_event_trigger_ddl_commands为执行的每个基本命令返回一行；某些作为单个 SQL 句子的命令可能会返回多行。此函数返回以下列：

名称类型说明
classidoid对象所属目录的 OID
objidoid对象本身的 OID
objsubidinteger子对象 ID（例如，列的属性编号）
command_tagtext命令标记
object_typetext对象的类型
schema_nametext对象所属架构的名称（如果存在）；否则为 NULL。不应用引号。
object_identitytext对象标识的文本呈现，架构限定。标识中包含的每个标识符在必要时都会加上引号。
in_extensionboolean如果命令是扩展脚本的一部分，则为 True
commandpg_ddl_command命令的完整表示，采用内部格式。这不能直接输出，但可以传递给其他函数以获取有关命令的不同信息。

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

pg_event_trigger_dropped_objects () → setof record

pg_event_trigger_dropped_objects返回在sql_drop事件中调用的命令删除的所有对象的列表。如果在任何其他上下文中调用，则会引发错误。此函数返回以下列：

名称类型说明
classidoid对象所属目录的 OID
objidoid对象本身的 OID
objsubidinteger子对象 ID（例如，列的属性编号）
originalboolean如果这是删除的根对象之一，则为 True
normalboolean如果在导致此对象的依赖关系图中存在正常依赖关系，则为 True
is_temporaryboolean如果这是临时对象，则为 True
object_typetext对象的类型
schema_nametext对象所属架构的名称（如果存在）；否则为 NULL。不应用引号。
object_nametext对象的名称，如果架构和名称的组合可用作对象的唯一标识符；否则为 NULL。不应用引号，并且名称永远不会以架构限定。
object_identitytext对象标识的文本呈现，架构限定。标识中包含的每个标识符在必要时都会加上引号。
address_namestext[]一个数组，与 object_type 和 address_args 结合使用，可由 pg_get_object_address 函数用于在包含同种同名对象的远程服务器中重新创建对象地址。
address_argstext[]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.29.3. 处理表重写事件# ​

表 9.104中显示的函数提供有关表的信息，该表刚刚调用了table_rewrite事件。如果在任何其他上下文中调用，则会引发错误。

表 9.104. 表重写信息函数

函数

说明

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