9.28. 事件触发功能

• 9 .28.1. 在命令端捕获更改

• 9 .28.2. 处理由 DDL 命令删除的对象

• 9 .28.3. 处理表重写事件

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

有关事件触发器的更多信息，请参见Chapter 40。

9 .28.1. 在命令端捕获更改

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

Name	Type	Description
classid	oid	对象所属目录的 OID
objid	oid	对象本身的 OID
objsubid	integer	子对象 ID(例如列的属性号)
command_tag	text	Command tag
object_type	text	对象类型
schema_name	text	对象所属模式的名称(如果有)；否则为NULL。不报价。
object_identity	text	对象标识的文本呈现，通过模式限定。必要时引用身份中包含的每个标识符。
in_extension	bool	如果命令是扩展脚本的一部分，则为 True
command	pg_ddl_command	命令的完整表示形式，内部格式。这不能直接输出，但是可以传递给其他函数以获得有关该命令的不同信息。

9 .28.2. 处理由 DDL 命令删除的对象

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

Name	Type	Description
classid	oid	对象所属目录的 OID
objid	oid	对象本身的 OID
objsubid	integer	子对象 ID(例如列的属性号)
original	bool	如果这是删除的根对象之一，则为真
normal	bool	如果在依赖图中导致该对象的依赖关系中存在正常的依赖关系，则为 True
is_temporary	bool	如果这是一个临时对象，则为 true
object_type	text	对象类型
schema_name	text	对象所属模式的名称(如果有)；否则为NULL。不报价。
object_name	text	对象的名称(如果架构和名称的组合可以用作对象的唯一标识符)；否则为NULL。没有引用被应用，并且名称从不被模式限定。
object_identity	text	对象标识的文本呈现，通过模式限定。必要时引用身份中包含的每个标识符。
address_names	text[]	pg_get_object_address()函数可以将数组与object_type和address_args一起用于在包含相同名称的相同对象的远程服务器中重新创建对象地址
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 .28.3. 处理表重写事件

Table 9.90中显示的功能提供有关刚刚为其调用table_rewrite事件的表的信息。如果在任何其他上下文中调用，则会引发错误。

表 9.90. 表重写信息

Name	Return Type	Description
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 FUNCTION test_event_trigger_table_rewrite_oid();