合 PG中的触发器
简介
PostgreSQL 触发器是数据库的回调函数,它会在指定的数据库事件发生时自动执行/调用。
下面是关于 PostgreSQL 触发器几个比较重要的点:
- PostgreSQL 触发器可以在下面几种情况下触发:
- 在执行操作之前(在检查约束并尝试插入、更新或删除之前)。
- 在执行操作之后(在检查约束并插入、更新或删除完成之后)。
- 更新操作(在对一个视图进行插入、更新、删除时)。
- 触发器的 FOR EACH ROW 属性是可选的,如果选中,当操作修改时每行调用一次;相反,选中 FOR EACH STATEMENT,不管修改了多少行,每个语句标记的触发器执行一次。
- WHEN 子句和触发器操作在引用 NEW.column-name 和 OLD.column-name 表单插入、删除或更新时可以访问每一行元素。其中 column-name 是与触发器关联的表中的列的名称。
- 如果存在 WHEN 子句,PostgreSQL 语句只会执行 WHEN 子句成立的那一行,如果没有 WHEN 子句,PostgreSQL 语句会在每一行执行。
- BEFORE 或 AFTER 关键字决定何时执行触发器动作,决定是在关联行的插入、修改或删除之前或者之后执行触发器动作。
- 要修改的表必须存在于同一数据库中,作为触发器被附加的表或视图,且必须只使用 tablename,而不是 database.tablename。
- 当创建约束触发器时会指定约束选项。这与常规触发器相同,只是可以使用这种约束来调整触发器触发的时间。当约束触发器实现的约束被违反时,它将抛出异常。
创建触发器语法
创建触发器时的基础语法如下:
1 2 3 4 5 | CREATE TRIGGER trigger_name [BEFORE|AFTER|INSTEAD OF] event_name ON table_name [ -- 触发器逻辑.... ]; |
在这里,event_name 可以是在所提到的表 table_name 上的 INSERT、DELETE 和 UPDATE 数据库操作。您可以在表名后选择指定 FOR EACH ROW。
以下是在 UPDATE 操作上在表的一个或多个指定列上创建触发器的语法:
1 2 3 4 5 | CREATE TRIGGER trigger_name [BEFORE|AFTER] UPDATE OF column_name ON table_name [ -- 触发器逻辑.... ]; |
实例
让我们假设一个情况,我们要为被插入到新创建的 COMPANY 表(如果已经存在,则删除重新创建)中的每一个记录保持审计试验:
1 2 3 4 5 6 7 | lhrpgdb=# CREATE TABLE COMPANY( ID INT PRIMARY KEY NOT NULL, NAME TEXT NOT NULL, AGE INT NOT NULL, ADDRESS CHAR(50), SALARY REAL ); |
为了保持审计试验,我们将创建一个名为 AUDIT 的新表。每当 COMPANY 表中有一个新的记录项时,日志消息将被插入其中:
1 2 3 4 | lhrpgdb=# CREATE TABLE AUDIT( EMP_ID INT NOT NULL, ENTRY_DATE TEXT NOT NULL ); |
在这里,ID 是 AUDIT 记录的 ID,EMP_ID 是来自 COMPANY 表的 ID,DATE 将保持 COMPANY 中记录被创建时的时间戳。所以,现在让我们在 COMPANY 表上创建一个触发器,如下所示:
1 | lhrpgdb=# CREATE TRIGGER example_trigger AFTER INSERT ON COMPANY FOR EACH ROW EXECUTE PROCEDURE auditlogfunc(); |
auditlogfunc() 是 PostgreSQL 一个程序,其定义如下:
1 2 3 4 5 6 | CREATE OR REPLACE FUNCTION auditlogfunc() RETURNS TRIGGER AS $example_table$ BEGIN INSERT INTO AUDIT(EMP_ID, ENTRY_DATE) VALUES (new.ID, current_timestamp); RETURN NEW; END; $example_table$ LANGUAGE plpgsql; |
现在,我们开始往 COMPANY 表中插入数据:
1 | lhrpgdb=# INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY) VALUES (1, 'Paul', 32, 'California', 20000.00 ); |
这时,COMPANY 表中插入了一条记录:
同时, AUDIT 表中也插入了一条记录,因为我们在插入 COMPANY 表时创建了一个触发器。相似的,我们也可以根据需求在更新和删除时创建触发器:
1 2 3 4 | emp_id | entry_date --------+--------------------------------- 1 | 2013-05-05 15:49:59.968+05:30 (1 row) |
CREATE TRIGGER — 定义一个新触发器
大纲
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | CREATE [ CONSTRAINT ] TRIGGER name { BEFORE | AFTER | INSTEAD OF } { event [ OR ... ] } ON table_name [ FROM referenced_table_name ] [ NOT DEFERRABLE | [ DEFERRABLE ] [ INITIALLY IMMEDIATE | INITIALLY DEFERRED ] ] [ REFERENCING { { OLD | NEW } TABLE [ AS ] transition_relation_name } [ ... ] ] [ FOR [ EACH ] { ROW | STATEMENT } ] [ WHEN ( condition ) ] EXECUTE { FUNCTION | PROCEDURE } function_name ( arguments ) 这里的event可以是下列之一: INSERT UPDATE [ OF column_name [, ... ] ] DELETE TRUNCATE |
描述
CREATE TRIGGER
创建一个新触发器。该触发器将被关联到指定的表、视图或者外部表并且在表上发生特定操作时将执行指定的函数function_name
。
该触发器可以被指定为在一行上尝试该操作之前触发(在约束被检查并且INSERT
、UPDATE
或者DELETE
被尝试之前);也可以在该操作完成之后触发(在约束被检查并且INSERT
、UPDATE
或者DELETE
完成之后);或者取代该操作(在对一个视图插入、更新或删除的情况中)。如果该触发器在事件之前触发或者取代事件,该触发器可以跳过对当前行的操作或者改变正在被插入的行(只对INSERT
以及UPDATE
操作)。如果该触发器在事件之后触发,所有更改(包括其他触发器的效果)对该触发器“可见”。
一个被标记为FOR EACH ROW
的触发器会对该操作修改的每一行都调用一次。例如,一个影响 10 行的DELETE
将导致在目标关系上的任何ON DELETE
触发器被独立调用 10 次,也就是为每一个被删除的行调用一次。与此相反,一个被标记为FOR EACH STATEMENT
的触发器只会为任何给定的操作执行一次,不管该操作修改多少行(特别地,一个修改零行的操作将仍会导致任何可用的FOR EACH STATEMENT
触发器被执行)。
被指定为要触发INSTEAD OF
触发器事件的触发器必须被标记为FOR EACH ROW
,并且只能被定义在视图上。一个视图上的BEFORE
和AFTER
触发器必须被标记为FOR EACH STATEMENT
。
此外,触发器可以被定义成为TRUNCATE
触发,但只能是FOR EACH STATEMENT
。
下面的表格总结了哪些触发器类型可以被用在表、视图和外部表上:
何时 | 事件 | 行级 | 语句级 |
---|---|---|---|
BEFORE | INSERT /UPDATE /DELETE | 表和外部表 | 表、视图和外部表 |
TRUNCATE | — | 表 | |
AFTER | INSERT /UPDATE /DELETE | 表和外部表 | 表、视图和外部表 |
TRUNCATE | — | 表 | |
INSTEAD OF | INSERT /UPDATE /DELETE | 视图 | — |
TRUNCATE | — | — |
还有,一个触发器定义可以指定一个布尔的WHEN
条件,它将被测试来看看该触发器是否应该被触发。在行级触发器中,WHEN
条件可以检查该行的列的新旧值。语句级触发器也可以有WHEN
条件,尽管该特性对于它们不是很有用(因为条件不能引用表中的任何值)。
如果有多个同种触发器被定义为相同事件触发,它们将按照名称的字母表顺序被触发。
当CONSTRAINT
选项被指定,这个命令会创建一个约束触发器。这和一个常规触发器相同,不过触发该触发器的时机可以使用SET CONSTRAINTS调整。约束触发器必须是表上的AFTER ROW
触发器。它们可以在导致触发器事件的语句末尾被引发或者在包含该语句的事务末尾被引发。在后一种情况中,它们被称作是被延迟。一个待处理的延迟触发器的引发也可以使用SET CONSTRAINTS
立即强制发生。当约束触发器实现的约束被违背时,约束触发器应该抛出一个异常。
REFERENCING
选项启用对传递关系的收集,传递关系是包括被当前SQL语句插入、删除或者修改的行的行集合。这个特性让触发器能看到该语句做的事情的全局视图,而不是一次只看到一行。仅对非约束触发器的AFTER
触发器允许这个选项。此外,如果触发器是一个UPDATE
触发器,则它不能指定column_name
列表。OLD TABLE
仅可以被指定一次,并且只能为在UPDATE
或DELETE
事件上引发的触发器指定,它创建的传递关系包含有该语句更新或删除的所有行的前映像。类似地,NEW TABLE
仅可以被指定一次,并且只能为在UPDATE
或INSERT
事件上引发的触发器指定,它创建的传递关系包含有该语句更新或插入的所有行的后映像。
SELECT
不修改任何行,因此你无法创建SELECT
触发器。规则和视图可以为需要SELECT
触发器的问题提供可行的解决方案。
关于触发器的更多信息请见第 38 章。
参数
name
给新触发器的名称。这必须与同一个表上的任何其他触发器相区别。名称不能是模式限定的 — 该触发器会继承它所在表的模式。对于一个约束触发器,这也是使用
SET CONSTRAINTS
修改触发器行为时要用到的名字。BEFORE
AFTER
INSTEAD OF
决定该函数是要在事件之前、之后被调用还是会取代该事件。一个约束触发器也能被指定为
AFTER
。event
INSERT
、UPDATE
、DELETE
或者TRUNCATE
之一,这指定了将要引发该触发器的事件。多个事件可以用OR
指定,要求传递关系的时候除外。对于UPDATE
事件,可以使用下面的语法指定一个列的列表:UPDATE OF *
column_name1* [, *
column_name2* ... ]
只有当至少一个被列出的列出现在UPDATE
命令的更新目标中时,或者如果列出的列之一是生成的列,而且依赖的列是UPDATE
的目标,该触发器才会触发。INSTEAD OF UPDATE
事件不允许列的列表。在请求传递关系时,也不能指定列的列表。table_name
要使用该触发器的表、视图或外部表的名称(可能是模式限定的)。
referenced_table_name
约束引用的另一个表的名称(可能是模式限定的)。这个选项被用于外键约束并且不推荐用于一般的目的。这只能为约束触发器指定。
DEFERRABLE
NOT DEFERRABLE
INITIALLY IMMEDIATE
INITIALLY DEFERRED
该触发器的默认时机。这些约束选项的细节可参考CREATE TABLE文档。这只能为约束触发器指定。
REFERENCING
这个关键词紧接在一个或者两个关系名的声明之前,这些关系提供对触发语句的传递关系的访问。
OLD TABLE
NEW TABLE
这个子句指示接下来的关系名是用于前映像传递关系还是后映像传递关系。
transition_relation_name
在该触发器中这个传递关系要使用的(未限定)名称。
FOR EACH ROW
FOR EACH STATEMENT
这指定该触发器函数是应该为该触发器事件影响的每一行被引发一次,还是只为每个 SQL 语句被引发一次。如果都没有被指定,
FOR EACH STATEMENT
会是默认值。约束触发器只能被指定为FOR EACH ROW
。condition
一个决定该触发器函数是否将被实际执行的布尔表达式。如果指定了
WHEN
,只有condition
返回true
时才会调用该函数。在FOR EACH ROW
触发器中,WHEN
条件可以分别写OLD.*
column_name*
或者NEW.*
column_name*
来引用列的新旧行值。当然,INSERT
触发器不能引用OLD
并且DELETE
触发器不能引用NEW
。INSTEAD OF
触发器不支持WHEN
条件。当前,WHEN
表达式不能包含子查询。注意对于约束触发器,对于WHEN
条件的计算不会被延迟,而是直接在行更新操作被执行之后立刻发生。如果该条件计算得不到真,那么该触发器就不会被放在延迟执行的队列中。function_name
一个用户提供的函数,它被声明为不用参数并且返回类型
trigger
,当触发器引发时会执行该函数。在CREATE TRIGGER
的语法中,关键词FUNCTION
和PROCEDURE
是等效的,但是任何情况下被引用的函数必须是一个函数而不是过程。这里,关键词PROCEDURE
的使用是有历史原因的并且已经被废弃。arguments
一个可选的逗号分隔的参数列表,它在该触发器被执行时会被提供给该函数。参数是字符串常量。简单的名称和数字常量也可以被写在这里,但是它们将全部被转换成字符串。请检查该触发器函数的实现语言的描述来找出在函数内部如何访问这些参数,这可能与普通函数参数不同。
注解
要在一个表上创建一个触发器,用户必须具有该表上的TRIGGER
特权。用户还必须具有在触发器函数上的EXECUTE
特权。
使用DROP TRIGGER移除一个触发器。
当一个列相关的触发器(使用UPDATE OF *
column_name*
语法定义的触发器)的列被列为UPDATE
命令的SET
列表目标时,它会被触发。即便该触发器没有被引发,一个列的值也可能改变,因为BEFORE UPDATE
触发器对行内容所作的改变不会被考虑。相反,一个诸如UPDATE ... SET x = x ...
的命令将引发一个位于列x
上的触发器,即便该列的值没有改变。
有一些内置的触发函数可用于解决常见问题,而无需编写您自己的触发代码。请参见第 9.28 节。
在一个BEFORE
触发器中,WHEN
条件正好在函数被或者将被执行之前被计算,因此使用WHEN
与在触发器函数的开始测试同一个条件没有实质上的区别。特别注意该条件看到的NEW
行是当前值,虽然可能已被早前的触发器所修改。还有,一个BEFORE
触发器的WHEN
条件不允许检查NEW
行的系统列(例如ctid
),因为那些列还没有被设置。
在一个AFTER
触发器中,WHEN
条件正好在行更新发生之后被计算,并且它决定一个事件是否要被放入队列以便在语句的末尾引发该触发器。因此当一个AFTER
触发器的WHEN
条件不返回真时,没有必要把一个事件放入队列或者在语句末尾重新取得该行。如果触发器只需要为一些行被引发,就能够显著地加快修改很多行的语句的速度。
在一些情况下,单一的SQL命令可能会引发多种触发器。例如,一个带有ON CONFLICT DO UPDATE
子句的INSERT
可能同时导致插入和更新操作,因此它将根据需要引发这两种触发器。提供给触发器的传递关系与它们的事件类型有关,因此INSERT
触发器将只看到被插入的行,而UPDATE
触发器将只看到被更新的行。
由外键强制动作导致的行更新或删除(例如ON UPDATE CASCADE
或ON DELETE SET NULL
)被当做导致它们的SQL命令的一部分。受影响的表上的相关触发器将被引发,这样就提供了另一种方法让SQL命令引发不直接匹配其类型的触发器。在简单的情况中,请求传递关系的触发器将在一个传递关系中看到由原始SQL命令在其表中做出的所有改变。不过,有些情况中一个请求传递关系的AFTER ROW
触发器的存在将导致由单个SQL命令触发的外键强制动作被分成多步,每一步都有其自己的传递关系。在这种情况下,没创建一个传递关系集合都会引发存在的所有语句级触发器,确保那些触发器能够在一个传递关系中看到每个受影响的行一次,并且只看到一次。