一个触发器声明了当执行一种特定类型的操作时数据库应该自动执行一个特殊的函数。触发器可以被附加到表(分区的或者不分区的)、视图和外部表。
在表和外部表上,触发器可以被定义为在
INSERT
、UPDATE
或
DELETE
操作之前或之后被执行,
可以为每个SQL语句被执行一次或者为每个修改的行
被执行一次。UPDATE
触发器可以进一步地设置为只针对UPDATE
语句的SET
子句的特定列出发。触发器也可以被
TRUNCATE
语句触发。如果一个触发器事件发生,
触发器函数会在适当的事件被调用来处理该事件。
在视图上,触发器可以被定义来取代INSERT
、UPDATE
或
DELETE
操作的执行。这种INSTEAD OF
触发器对视图中需要被修改的每一行触发一次。触发器函数的职责是对视图的底层基本表执行必要的修改,并且在合适的时候返回被修改的行以便显示在视图中。视图上的触发器也可以被定义为对每个SQL语句执行一次,在INSERT
\UPDATE
或DELETE
操作之前或之后。不过,只有在该视图上还有一个INSTEAD OF
触发器时,上述那些触发器才会被触发。否则,以该视图为目标的任何语句都必须被重写成一个影响其底层基表的语句,然后附着在那些基表上的触发器将会被引发。
触发器函数必须在触发器本身被创建之前被定义好。触发器函数必须被定义成一个没有参数的函数,并且返回类型为trigger
(触发器函数通过一个特殊传递的TriggerData
结构作为其输入,而不是以普通函数参数的形式)。
一旦一个合适的触发器函数被创建,就可以使用CREATE TRIGGER建立触发器。同一个触发器函数可以被用于多个触发器。
LightDB同时提供每行的触发器和每语句的触发器。对于一个每行的触发器,对于触发触发器的语句所修改的每一行都会调用一次触发器函数。相反,一个每语句的触发器对于其触发语句只被调用一次,而不管该语句影响了多少行。特别地,一个不影响任何行的语句仍然会导致任何可用每语句的触发器的执行。这两类触发器有时也分别被称作行级触发器和语句级触发器。TRUNCATE
上的触发器只能被定义在语句级。
触发器也可以根据它们是否在操作之前、之后触发,或者被触发来取代操作来分类。它们分别指BEFORE
触发器、AFTER
触发器以及INSTEAD OF
触发器。语句级BEFORE
触发器在语句开始做任何事情之前被触发,而语句级AFTER
触发器则在语句做完所有事情之后被触发。这些触发器类型可以被定义在表、视图或外部表上。行级BEFORE
触发器在每一个行被操作之前被触发,而行级AFTER
触发器在语句结束之后被触发(但在任何语句级AFTER
触发器之前)。这些触发器类型只能被定义在表和外部表上,但不能定义在视图上。INSTEAD OF
触发器只能被定义在视图上,并且只能定义在行级,当视图中的每一行被标识为需要被操作时,它们会立即触发。
一个AFTER
触发器的执行可以推迟到事务的最后,而不是语句的最后,如果它被定义为constraint trigger。
在所有情况下,触发器作为触发它的语句的同一个事务的一部分来执行,所以无论语句或触发器导致错误,两者的后果都将会回滚。
一个以继承或者分区层次中父表为目标的语句不会导致受影响的子表的语句级触发器被引发,只有父表的语句级触发器会被引发。不过,受影响的子表的行级触发器将被引发。
如果一个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
触发器。
如果一个分区表上的UPDATE
导致一行移动到另一个分区,它将被从原始分区DELETE
掉然后再INSERT
到新分区中。在这种情况下,原始分区上所有的行级BEFORE
UPDATE
触发器和所有行级BEFORE
DELETE
触发器会被引发。然后目标分区上所有的行级BEFORE
INSERT
触发器会被引发。当所有这些触发器都影响被移动的行时,应该对令人惊讶的结果有心理准备。至于AFTER ROW
触发器,AFTER
DELETE
和AFTER
INSERT
触发器会被应用,但AFTER
UPDATE
触发器不会被应用,因为UPDATE
已经被转换成了一个DELETE
和一个INSERT
。对于语句级触发器,即便发生行移动,DELETE
和INSERT
触发器也都不会被引发,只有UPDATE
语句中用到的目标表上的UPDATE
触发器将被引发。
被语句级触发器调用的触发器函数应该总是返回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
触发器之后和 AFTER
触发器之前计算.
因此,生成的值可以在AFTER
触发器中检查。
在BEFORE
触发器中,OLD
行包含旧的生成的值,正如人们所期待的,但 NEW
行尚未包含新的生成值并且不应访问。
在C语言界面中,此时列的内容还没有被定义;在BEFORE
触发器中,高级别编程语言应阻止访问NEW
行中存储生成的列,。
在BEFORE
触发器中更改到生成列的值将被忽略并覆盖。
如果为同一个关系上的同一事件定义了超过一个触发器,它们将按照其名称的字母表顺序被触发。在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
行。语句级触发器当前没有任何方法检查被语句修改的单个行。
默认情况下,语句级触发器没有办法检查该语句修改的行。但是AFTER STATEMENT
触发器可以请求创建传递表,这样可以让受影响的行集合对该触发器可用。AFTER ROW
触发器也可以请求传递表,这样它们可以看到表中的整个变化,同时也能看到当前引发它们的个体行中的变化。检查传递表的方法仍是取决于使用的编程语言,但是通常的方法让传递表变得像触发器函数内部发出的SQL命令能够访问的只读临时表一样。