CREATE [ OR REPLACE ] [ 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 )

where event can be one of:

    INSERT
    UPDATE [ OF column_name [, ... ] ]
    DELETE
    TRUNCATE

描述

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 触发器的问题提供可行的解决方案。

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

参数

注释

要在表上创建或替换触发器，用户必须具有该表的 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.28 节。

示例

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

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

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

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();

第 39.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 选项也是如此。

另请参见

ALTER TRIGGER、DROP TRIGGER、CREATE FUNCTION、SET CONSTRAINTS