参数

备注

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

使用 DROP TRIGGER 删除触发器。

在分区表上创建行级别触发器将导致每在其现有分区上创建相同的“克隆”触发器；并且稍后创建或附加的任意分区也将具有相同的触发器。如果一个子分区上已有冲突命名的触发器，那么将发生错误，除非使用CREATE OR REPLACE TRIGGER，在这种情况下将用一个克隆触发器替换那个触发器。当一个分区从其父分区分离后，将删除其克隆触发器。

当一个列的任意部分在UPDATE命令的SET列表中作为目标列时，会触发一个特定于列的触发器（一个使用UPDATE OF column_name语法定义的触发器）。即使没有触发触发器，列的值仍然可能改变，原因是BEFORE UPDATE触发器对行内容所做的更改不被考虑。相反，诸如UPDATE ... SET x = x ...之类的命令将触发列x上的一个触发器，即使该列的值没有改变。

在BEFORE触发器中，WHEN条件会在函数被执行或将被执行之前立即被评估，因此使用WHEN从本质上来说与在触发器函数开始时测试相同条件没有什么不同。特别注意条件所看到的NEW行是当前值，而且可能被更早的触发器所修改。另外，BEFORE触发器的WHEN条件不被允许检查NEW行的系统列（例如ctid），因为这些列尚未被设置。

在AFTER触发器中，WHEN条件会在行更新发生之后立即被评估，并且它会确定在语句结束时是否对一个事件排队来触发触发器。因此，当AFTER触发器的WHEN条件不返回 true 时，就不必对事件排队或在语句结束时重新获取行。如果触发器只需要为几行触发，那么这可以在修改多行的语句中产生明显的加速。

在某些情况下，一个 SQL 命令可以激发多种类型的触发器。例如，带有 INSERT 和 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();

修改触发器定义，以便仅当 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();

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

兼容性

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

SQL 规定应按创建时间顺序触发 multiple triggers。 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