PostgreSQL 9.5.3 文档 | |||
---|---|---|---|
上一页 | 上一级 | 章 36. 触发器 | 下一页 |
一个触发器声明了当执行一种特定类型的操作时数据库应该自动执行一个特殊的函数。触发器可以被附加到表、视图和外部表。
在表和外部表上,触发器可以被定义为在INSERT、UPDATE或 DELETE操作之前或之后被执行,可以为每个SQL 语句执行一次或者为每个修改的行执行一次。如果一个INSERT包含 ON CONFLICT DO UPDATE子句,并且如果出现了一个对于EXCLUDED列的引用, 一个BEFORE 插入触发器和 一个 BEFORE 更新触发器可能都会被触发。 UPDATE触发器可以进一步地设置为只针对UPDATE 语句的SET子句的特定列触发。触发器也可以被TRUNCATE 语句触发。如果一个触发器事件发生,触发器函数会在适当的时间被调用来处理该事件。 外部表完全不支持 TRUNCATE 语句。
在视图上,触发器可以被定义来取代INSERT、UPDATE或 DELETE操作的执行。INSTEAD OF触发器对视图中需要被修改的每一行触发一次。触发器函数的职责是对底层的基本表执行必要的修改,并且在合适的时候返回被修改的行以便显示在视图中。视图上的触发器也可以被定义为对每个SQL语句执行一次,在INSERT\UPDATE或DELETE操作之前或之后。
触发器函数必须在触发器本身被创建之前被定义好。触发器函数必须被定义成一个没有参数的函数,并且返回类型为trigger(触发器函数通过一个特殊传递的TriggerData结构作为其输入,而不是以普通函数参数的形式)。
一旦一个合适的触发器函数被创建,就可以使用CREATE TRIGGER建立触发器。同一个触发器函数可以被用于多个触发器。
PostgreSQL同时提供每行的触发器和每语句的触发器。对于一个每行的触发器,对于触发触发器的语句所修改的每一行都会调用一次触发器函数。相反,一个每语句的触发器对于其触发语句只被调用一次,而不管该语句影响了多少行。特别地,一个不影响任何行的语句仍然会导致任何可用每语句的触发器的执行。这两类触发器有时也分别被称作行级触发器和语句级触发器。TRUNCATE上的触发器只能被定义在语句级。在视图上,前触发或后触发的触发器只能被定义在语句级,而取代INSERT、UPDATE或DELETE的触发器只能被定义在行级。
触发器也可以根据它们是否在操作之前、之后触发,或者被触发来取代操作来分类。它们分别指BEFORE触发器、AFTER 触发器以及INSTEAD OF触发器。语句级BEFORE触发器在语句开始做任何事情之前被触发,而语句级AFTER触发器则在语句做完所有事情之后被触发。这些触发器类型可以被定义在表或视图上。行级BEFORE触发器在每一个行被操作之前被触发,而行级AFTER触发器在语句结束之后被触发(但在任何语句级AFTER触发器之前)。这些触发器类型只能被定义在表和外部表上。行级INSTEAD OF触发器只能被定义在视图上,并立刻为视图中每一个被标识为需要被操作的行触发。
如果一个INSERT包含ON CONFLICT DO UPDATE 子句并且引用了EXCLUDED列,有可能所有行级BEFORE INSERT 触发器和所有行级 BEFORE UPDATE 触发器的效果可能会以一种对于被更新行最终状态透明的方式被应用。不过, 对于要执行的两种集合的行级 BEFORE触发器都不需要有EXCLUDED 列引用。当同时有行级BEFORE INSERT和 BEFORE UPDATE触发器影响被插入/更新的行时 (如果在两者不幂等时修改或多或少地等价,这仍可能是有问题的), 应该考虑可能出现的意料之外的结果。注意在指定了ON CONFLICT DO UPDATE 时,不管有没有行被UPDATE影响(并且不管是否采用了其他 UPDATE路径),语句级UPDATE 触发器都将被执行。一个带有ON CONFLICT DO UPDATE子句的 INSERT将首先执行语句级BEFORE INSERT 触发器, 然后执行语句级BEFORE UPDATE触发器, 接着是语句级AFTER UPDATE触发器, 最后是语句级AFTER INSERT触发器。
被语句级触发器调用的触发器函数应该总是返回NULL。根据行级触发器的选择,被其调用的触发器函数可以返回一个表行(类型HeapTuple的一个值)给执行器。在一个操作前触发的行级触发器有下列选择:
它可以返回NULL来跳过对当前行的操作。这指示执行器不要执行调用触发器的行级操作(对一个特定表行的插入、修改或删除)。
仅对行级INSERT和UPDATE触发器来说,被返回的行称为将要被插入的行或者替代将被更新的行。这允许触发器函数修改将要被插入或更新的行。
一个无意导致任何这些行为的行级BEFORE触发器必须小心地它的结果,使之和被传入的行一样(即,INSERT和UPDATE触发器的NEW行,DELETE触发器的OLD行)。
一个行级INSTEAD OF触发器可以返回NULL来指示它没有修改任何来自于视图底层基表的数据,也可以返回被传入的视图行(INSERT和UPDATE操作的NEW行,或者DELETE操作的OLD行)。一个非空返回值被用于标志触发器在视图中执行了必须的数据修改。这将会导致被命令修改的行计数被增加。对于INSERT和UPDATE操作,触发器可能会在返回NEW行之前对其进行修改。这将会改变INSERT RETURNING或UPDATE RETURNING返回的数据,并在视图无法正确地显示提供给它的相同数据时有用。
对于在一个操作之后触发的行级触发器,返回值会被忽略,因此它们可以返回NULL。
如果为同一个关系上的同一事件定义了超过一个触发器,它们将按照其名称的字母表顺序被触发。在BEFORE和INSTEAD OF触发器的情况下,每一个触发器返回的可能被修改的行将成为下一个触发器的输入。如果任何一个BEFORE或INSTEAD OF触发器返回NULL,该操作将在该行上被禁用并且对于该行不会触发后续的触发器。
一个触发器定义也能指定一个布尔的WHEN条件,它将被测试来看该触发器是否应该被触发。在行级触发器中,WHEN条件可以检查该行的旧列值和/或新列值(语句级触发器也能有WHEN条件,但是该特性对它们不太有用)。在一个BEFORE触发器中,WHEN条件只是在该函数被或者将被执行前计算,因此使用WHEN条件与在该触发器函数的开始测试相同的条件没有本质区别。不过,在一个AFTER触发器中,WHEN条件只是在行更新发生之后被计算,并且它决定在语句的末尾一个事件是否被排队来触发该触发器。因此当一个AFTER触发器的WHEN不返回真时,在语句的末尾没有必要将一个事件进行排队,也没有必要重新取出该行。如果触发器只对少数行触发,这可以使得修改很多行的语句明显加快。INSTEAD OF触发器不支持WHEN条件。
通常,行级BEFORE被用来检查或修改即将被插入或更新的数据。例如,一个BEFORE触发器可以被用来把当前时间插入到一个timestamp列中,或者检查该行的两个元素之间是否一致。行级AFTER触发器大多数被用来将更新传播到其他表,或者针对其他表进行一致性检查。进行这种工作分工的原因是,一个AFTER触发器可以肯定它看到的是该行的最终值,而一个BEFORE触发器则不能,因为还可能有其他BEFORE触发器在它之后触发。如果你不知道让一个触发器是BEFORE或AFTER,则BEFORE形式更加有效,因为关于该操作的信息直到语句的末尾都不需要被保存。
如果一个触发器函数执行 SQL 命令,则这些命令可能会再次引发触发器。这就是所谓的级联触发器。对于级联的层数没有直接的限制。级联有可能会导致对同一个触发器的递归调用。例如,一个INSERT触发器可能执行一个向同一个表插入一个额外行的命令,这就导致该INSERT触发器被再次引发。所以在这种情形下,触发器程序员应该负责避免无限递归。
在定义一个触发器时,可以为它指定参数。在触发器定义中包括参数的目的是允许具有相似需求的不同触发器调用同一个函数。例如,可能有一个一般性的触发器函数,它需要两个列名作为参数,一个放当前用户而另一个放当前时间戳。在正确编写的情况下,这个触发器函数应该独立于它所触发的表。因此同一个函数可以被用于具有适当列的任意表上的INSERT事件,这样做的用途之一是可以自动追踪一个交易表中记录的创建。如果被定义成一个UPDATE触发器,它也可以被用来追踪最新的更新事件。
每一种支持触发器的编程语言都有自己的方法来让触发器输入数据对触发器函数可用。这种输入数据包括触发器事件的类型(如INSERT或UPDATE)以及被列在CREATE TRIGGER中的任何参数。对于一个行级触发器,输入数据还包括用于INSERT和UPDATE触发器的NEW行,和/或用于UPDATE和DELETE触发器的OLD行。语句级触发器当前没有任何方法检查被语句修改的单个行。