描述

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触发器执行）。

此外，也可以把触发器定义为在 TRUNCATE 时引发，但只能是 FOR EACH STATEMENT。

此外，触发器定义还可以指定一个布尔型 WHEN 条件，用于测试是否应当引发该触发器。在行级触发器中，WHEN 条件可以检查该行各列的新值和/或旧值。语句级触发器也可以带有 WHEN 条件，不过这一特性对它们的用处不大，因为该条件无法引用表中的任何值。

如果针对同一事件定义了多个同类触发器，它们将按名称的字母顺序引发。

SELECT 不会修改任何行，因此无法创建 SELECT 触发器。对于这类情形，规则和视图更为合适。

参见第 36 章以了解有关触发器的更多信息。

参数

注解

要在表上创建触发器，用户必须拥有该表的TRIGGER权限。用户还必须拥有触发器函数的EXECUTE权限。

使用DROP TRIGGER删除触发器。

列限定触发器（即使用 UPDATE OF column_name 语法定义的触发器）会在其任一列被列为 UPDATE 命令的 SET 列表目标时引发。即便触发器没有引发，列值仍有可能发生变化，因为 BEFORE UPDATE 触发器对行内容所作的更改不会被考虑在内。反过来，诸如 UPDATE ... SET x = x ... 这样的命令会引发列 x 上的触发器，即使该列的值实际上并未变化。

在BEFORE触发器中，WHEN条件会在函数执行前（或者本应执行前）立即求值，因此使用WHEN与在触发器函数开头测试相同条件并无实质区别。特别要注意的是，该条件看到的NEW行是当前值，它可能已经被更早触发的触发器修改过。此外，BEFORE触发器的WHEN条件不允许检查NEW行的系统列（例如oid），因为这些列此时尚未被设置。

在 AFTER 触发器中，WHEN 条件会在行变更发生后立即求值，并决定是否将一个事件排入队列，以便在语句结束时引发该触发器。因此，当 AFTER 触发器的 WHEN 条件不返回真时，就没有必要将事件排队，也不需要在语句结束时重新获取该行。如果触发器只需针对少数几行引发，这能显著提升那些会修改很多行的语句的速度。

在PostgreSQL 7.3 之前的版本中，必须将触发器函数声明为返回占位类型opaque，而不是trigger。为了支持加载旧转储文件，CREATE TRIGGER将接受声明为返回opaque的函数，但会发出通知，并将该函数声明的返回类型更改为trigger。

示例

每当表accounts的一行即将被更新时，执行函数check_account_update：

CREATE TRIGGER check_update
    BEFORE UPDATE ON accounts
    FOR EACH ROW
    EXECUTE PROCEDURE check_account_update();

相同，但只有当列balance被指定为UPDATE命令中的一个目标时才执行该函数：

CREATE TRIGGER check_update
    BEFORE UPDATE OF balance ON accounts
    FOR EACH ROW
    EXECUTE PROCEDURE check_account_update();

这种形式只在列balance的值确实发生了改变时才执行该函数：

CREATE TRIGGER check_update
    BEFORE UPDATE ON accounts
    FOR EACH ROW
    WHEN (OLD.balance IS DISTINCT FROM NEW.balance)
    EXECUTE PROCEDURE check_account_update();

调用一个函数来记录accounts的更新，但只在有变化发生时：

CREATE TRIGGER log_update
    AFTER UPDATE ON accounts
    FOR EACH ROW
    WHEN (OLD.* IS DISTINCT FROM NEW.*)
    EXECUTE PROCEDURE log_account_update();

第 36.4 节包含一个用 C 编写的触发器函数的完整示例。

兼容性

PostgreSQL 中的 CREATE TRIGGER 语句实现了 SQL 标准的一个子集。当前仍缺少以下功能：

SQL 规定多个触发器应按创建时间顺序引发。PostgreSQL 则按名称顺序引发，这被认为更方便。

SQL 规定，级联删除上的 BEFORE DELETE 触发器应在级联 DELETE 完成之后引发。PostgreSQL 的行为则是 BEFORE DELETE 总会在删除动作之前引发，即使是级联删除也一样。这被认为更一致。如果 BEFORE 触发器在由引用动作引起的更新过程中修改行或阻止更新，也会出现非标准行为。这可能导致约束违反，或者使存储的数据不符合引用约束。

使用 OR 为单个触发器指定多个动作的能力，是 PostgreSQL 对 SQL 标准的扩展。

为TRUNCATE引发触发器的能力是PostgreSQL对 SQL 标准的一个扩展。

参见