描述

CREATE TRIGGER 创建一个新的触发器。 CREATE OR REPLACE TRIGGER 将创建新的触发器，或替换现有触发器。触发器将与指定的表、视图或外部表关联，并在对该表执行某些操作时执行指定的函数 function_name。

要替换现有触发器的当前定义，请使用 CREATE OR REPLACE TRIGGER，指定现有触发器的名称和父表。所有其他属性都将被替换。

可以将触发器指定为在尝试对行执行操作之前触发（在检查约束并尝试执行 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。

下表总结了哪些类型的触发器可用于表、视图和外部表

此外，触发器定义可以指定一个布尔型 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 触发器的问题提供可行的解决方案。

有关触发器的更多信息，请参阅 第 37 章。

参数

注意

要在一个表上创建或替换一个触发器，用户必须对该表具有 TRIGGER 权限。 用户还必须对触发函数具有 EXECUTE 权限。

使用 DROP TRIGGER 删除触发器。

在一个分区表上创建一个行级触发器将导致在每个现有的分区上创建一个相同的 “克隆” 触发器； 以后创建或附加的任何分区也将有一个相同的触发器。 如果子分区上已经有名称冲突的触发器，则会发生错误，除非使用 CREATE OR REPLACE TRIGGER，在这种情况下，该触发器将被替换为克隆触发器。 当一个分区从其父分区分离时，其克隆触发器将被删除。

一个特定于列的触发器（使用 UPDATE OF column_name 语法定义的）将在 UPDATE 命令的 SET 列表中列出其任何列作为目标时触发。 列的值可能在触发器未触发时发生变化，因为 BEFORE UPDATE 触发器对行内容所做的更改不被认为是更改。 相反，像 UPDATE ... SET x = x ... 这样的命令会触发列 x 上的触发器，即使列的值没有改变。

在一个 BEFORE 触发器中，WHEN 条件在函数执行或将要执行之前进行评估，因此使用 WHEN 与在触发函数开头测试相同的条件在本质上没有区别。 特别要注意，条件所看到的 NEW 行是当前值，可能被先前的触发器修改过。 此外，BEFORE 触发器的 WHEN 条件不允许检查 NEW 行的系统列（如 ctid），因为这些列还没有设置。

在一个 AFTER 触发器中，WHEN 条件在行更新发生后立即进行评估，它决定是否将一个事件排队，以便在语句结束时触发触发器。 因此，当 AFTER 触发器的 WHEN 条件没有返回 true 时，没有必要排队事件或在语句结束时重新获取行。 如果触发器只需要为几行触发，这可能会导致修改许多行的语句的显著加速。

在某些情况下，单个 SQL 命令可能会触发多种类型的触发器。 例如，具有 ON CONFLICT DO UPDATE 子句的 INSERT 可能会导致插入和更新操作，因此它将根据需要触发两种类型的触发器。 提供给触发器的转换关系特定于它们的事件类型； 因此，INSERT 触发器只会看到插入的行，而 UPDATE 触发器只会看到更新的行。

由外键强制操作（如 ON UPDATE CASCADE 或 ON DELETE SET NULL）引起的行的更新或删除被视为引起它们 SQL 命令的一部分（请注意，此类操作永远不会延迟）。 将触发受影响表的相关触发器，因此这提供了另一种方式，即 SQL 命令可能触发与其类型不直接匹配的触发器。 在简单情况下，请求转换关系的触发器将看到由单个原始 SQL 命令在它们表中引起的全部更改，作为一个单一的转换关系。 但是，有些情况下，存在请求转换关系的 AFTER ROW 触发器会导致单个 SQL 命令触发的外键强制操作被拆分为多个步骤，每个步骤都有自己的转换关系集。 在这种情况下，任何存在的语句级触发器将在每次创建转换关系集时触发一次，确保触发器在转换关系中看到每个受影响的行一次且只有一次。

视图上的语句级触发器只有在视图上的操作由行级 INSTEAD OF 触发器处理时才会触发。 如果操作由 INSTEAD 规则处理，则规则发出的任何语句都将代替命名视图的原始语句执行，因此触发的触发器是替换语句中命名的表的触发器。 同样，如果视图是自动可更新的，则该操作将通过自动将语句重写为视图基础表上的操作来处理，因此基础表的语句级触发器是触发器。

修改一个分区表或一个具有继承子表的表将触发附加到显式命名表的语句级触发器，但不触发其分区或子表的语句级触发器。 相反，即使在查询中没有显式命名，行级触发器也会在受影响的分区或子表中的行上触发。 如果一个语句级触发器是使用 REFERENCING 子句命名的转换关系定义的，那么所有受影响的分区或子表的行之前和之后的图像都是可见的。 在继承子表的情况下，行图像仅包括附加触发器所在的表中存在的列。

目前，带有转换关系的行级触发器不能在分区或继承子表上定义。 此外，分区表上的触发器不能是 INSTEAD OF。

目前，对于约束触发器，不支持 OR REPLACE 选项。

在一个已经对触发器表的更新操作执行了的交易中，替换现有的触发器是不推荐的。 已经做出的触发器触发决策或部分触发决策将不会被重新考虑，因此其影响可能会令人惊讶。

有一些内置的触发器函数可以用来解决常见问题，而无需编写自己的触发器代码； 请参阅 第 9.29 节。

例子

每当要更新表 accounts 的一行时，执行函数 check_account_update

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

修改该触发器定义，只有在 UPDATE 命令中指定列 balance 作为目标时才执行该函数

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

这种形式只有在列 balance 的值实际上改变时才执行该函数

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

调用一个函数来记录 accounts 的更新，但只有在某些内容发生改变时才记录

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

为每一行执行函数 view_insert_row，以将行插入到视图的基础表中

CREATE TRIGGER view_insert
    INSTEAD OF INSERT ON my_view
    FOR EACH ROW
    EXECUTE FUNCTION view_insert_row();

为每个语句执行函数 check_transfer_balances_to_zero，以确认 transfer 行偏移到净值为零

CREATE TRIGGER transfer_insert
    AFTER INSERT ON transfer
    REFERENCING NEW TABLE AS inserted
    FOR EACH STATEMENT
    EXECUTE FUNCTION check_transfer_balances_to_zero();

为每一行执行函数 check_matching_pairs，以确认更改是在同一时间（通过同一个语句）对匹配对进行的

CREATE TRIGGER paired_items_update
    AFTER UPDATE ON paired_items
    REFERENCING NEW TABLE AS newtab OLD TABLE AS oldtab
    FOR EACH ROW
    EXECUTE FUNCTION check_matching_pairs();

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

兼容性

PostgreSQL 中的 CREATE TRIGGER 语句实现了以下内容的子集SQL标准。 以下功能目前缺失

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

SQL 规范规定，在级联删除时，BEFORE DELETE 触发器会在级联 DELETE 完成 之后 触发。PostgreSQL 的行为是，BEFORE DELETE 始终在删除操作之前触发，即使是级联删除也是如此。这被认为更加一致。如果 BEFORE 触发器在由引用操作引起的更新期间修改了行或阻止了更新，也会出现非标准行为。这会导致约束违反或存储数据不符合引用约束。

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

为 TRUNCATE 触发触发器的能力是 PostgreSQL 对 SQL 标准的扩展，与为视图定义语句级触发器的能力一样。

CREATE CONSTRAINT TRIGGER 是 PostgreSQL 对SQL标准的扩展。OR REPLACE 选项也是如此。

另请参阅