PostgreSQL 10.1 手册_部分 II. SQL 语言_第 9 章 函数和操作符_9.28. 事件触发器函数

本文涉及的产品
云原生数据库 PolarDB MySQL 版,通用型 2核4GB 50GB
云原生数据库 PolarDB PostgreSQL 版,标准版 2核4GB 50GB
简介: 9.28. 事件触发器函数 9.28.1. 捕获命令结尾的改变 9.28.2. 通过DDL命令删除处理的对象 9.28.3. 处理表重写事件 PostgreSQL提供这些帮助函数用以从事件触发器中检索信息。

9.28. 事件触发器函数

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

关于事件触发器的更多信息,参见第 39 章

9.28.1. 捕获命令结尾的改变

pg_event_trigger_ddl_commands返回通过 每个用户操作执行的DDL命令列表, 当调用函数中ddl_command_end事件触发器, 如果在任何其它上下文中调用,则抛出一个错误。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命令删除处理的对象

pg_event_trigger_dropped_objects返回其sql_drop事件中命令所删除的所有对象的列表。如果在任何其他环境中被调用,pg_event_trigger_dropped_objects将抛出一个错误。pg_event_trigger_dropped_objects返回下列列:

名称 类型 描述
classid Oid 对象所属的目录的 OID
objid Oid 在目录中的对象的 OID
objsubid int32 对象的子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.90中的函数提供关于表的信息, 其中table_rewrite事件刚刚被调用。如果在任何其它上下文中调用,则抛出错误。

表 9.90. 表重写信息

名称 返回类型 描述
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();

本文转自PostgreSQL中文社区,原文链接:9.28. 事件触发器函数

相关实践学习
使用PolarDB和ECS搭建门户网站
本场景主要介绍基于PolarDB和ECS实现搭建门户网站。
阿里云数据库产品家族及特性
阿里云智能数据库产品团队一直致力于不断健全产品体系,提升产品性能,打磨产品功能,从而帮助客户实现更加极致的弹性能力、具备更强的扩展能力、并利用云设施进一步降低企业成本。以云原生+分布式为核心技术抓手,打造以自研的在线事务型(OLTP)数据库Polar DB和在线分析型(OLAP)数据库Analytic DB为代表的新一代企业级云原生数据库产品体系, 结合NoSQL数据库、数据库生态工具、云原生智能化数据库管控平台,为阿里巴巴经济体以及各个行业的企业客户和开发者提供从公共云到混合云再到私有云的完整解决方案,提供基于云基础设施进行数据从处理、到存储、再到计算与分析的一体化解决方案。本节课带你了解阿里云数据库产品家族及特性。
相关文章
|
4月前
|
SQL 存储 数据管理
深入理解SQL中的触发器
【8月更文挑战第31天】
65 0
|
5月前
|
SQL 数据库
SQL LIKE 操作符
【7月更文挑战第12天】SQL LIKE 操作符。
41 14
|
5月前
|
SQL 数据库
SQL BETWEEN 操作符
【7月更文挑战第14天】SQL BETWEEN 操作符。
48 10
|
5月前
|
SQL 数据库
SQL LIKE 操作符
【7月更文挑战第13天】SQL LIKE 操作符。
43 7
|
5月前
|
SQL
SQL LIKE 操作符实例
【7月更文挑战第13天】SQL LIKE 操作符实例
40 5
|
5月前
|
SQL 数据库
SQL BETWEEN 操作符
【7月更文挑战第15天】SQL BETWEEN 操作符。
35 3
|
6月前
|
SQL 数据库
SQL UNION 操作符
SQL UNION 操作符
62 3
|
6月前
|
存储 SQL 数据库
SQL 语言:存储过程和触发器
SQL 语言:存储过程和触发器
94 6
|
6月前
|
SQL 数据库
SQL BETWEEN 操作符
SQL BETWEEN 操作符
26 1
|
6月前
|
SQL 数据库
SQL IN 操作符
SQL IN 操作符
31 3