13.1.22 CREATE TRIGGER 语句_MySQL 8.0 参考手册

MySQL 8.0 参考手册 / 第 13 章 SQL 语句 / 13.1 数据定义语句 / 13.1.22 CREATE TRIGGER 语句

13.1.22 CREATE TRIGGER 语句

CREATE
    [DEFINER = user]
    TRIGGER [IF NOT EXISTS] trigger_name
    trigger_time trigger_event
    ON tbl_name FOR EACH ROW
    [trigger_order]
    trigger_body

trigger_time: { BEFORE | AFTER }

trigger_event: { INSERT | UPDATE | DELETE }

trigger_order: { FOLLOWS | PRECEDES } other_trigger_name

此语句创建一个新触发器。触发器是与表关联的命名数据库对象，当表发生特定事件时激活。触发器与名为的表相关联，该表 tbl_name必须引用永久表。您不能将触发器与 TEMPORARY表或视图相关联。

触发器名称存在于模式命名空间中，这意味着所有触发器在模式中必须具有唯一名称。不同模式中的触发器可以具有相同的名称。

IF NOT EXISTS如果同一个表上的同名触发器存在于同一个模式中，则可以防止发生错误。CREATE TRIGGER从 MySQL 8.0.29 开始支持此选项。

本节介绍CREATE TRIGGER语法。有关其他讨论，请参阅第 25.3.1 节，“触发器语法和示例”。

CREATE TRIGGER需要 TRIGGER与触发器关联的表的特权。如果DEFINER 存在该子句，则所需的权限取决于 user值，如第 25.6 节“存储对象访问控制”中所述。如果启用二进制日志记录，CREATE TRIGGER可能需要SUPER权限，如第 25.7 节“存储程序二进制日志记录”中所述。

该DEFINER子句确定在触发器激活时检查访问权限时要使用的安全上下文，如本节后面所述。

trigger_time是触发动作时间。它可以是BEFORE或 AFTER表示触发器在要修改的每一行之前或之后激活。

基本列值检查发生在触发器激活之前，因此您不能使用BEFORE触发器将不适合列类型的值转换为有效值。

trigger_event指示激活触发器的操作类型。这些 trigger_event值是允许的：

INSERT：只要有新行插入表中（例如，通过、和语句），触发器INSERT就会 LOAD DATA激活 REPLACE。
UPDATE：只要一行被修改（例如，通过 UPDATE语句），触发器就会激活。
DELETE：只要从表中删除一行（例如，通过 DELETE和 REPLACE语句），触发器就会激活。 DROP TABLE表上的和 TRUNCATE TABLE语句不会激活此触发器，因为它们不使用DELETE. 删除分区也不会激活 DELETE触发器。

trigger_event与其说它代表了一种表操作类型，不如说它代表了激活触发器的一种文字类型的 SQL 语句。例如， INSERT触发器不仅对INSERT语句激活，而且对语句也激活，LOAD DATA因为这两个语句都将行插入到表中。

一个可能令人困惑的例子是INSERT INTO ... ON DUPLICATE KEY UPDATE ...语法：一个 BEFORE INSERT触发器激活每一行，然后是一个AFTER INSERT触发器或两个触发器BEFORE UPDATE，AFTER UPDATE这取决于该行是否有重复的键。

笔记

级联的外键操作不会激活触发器。

可以为具有相同触发事件和动作时间的给定表定义多个触发器。例如，您可以BEFORE UPDATE为一个表设置两个触发器。默认情况下，具有相同触发事件和动作时间的触发器按创建顺序激活。要影响触发器顺序，请指定一个trigger_order子句，该子句指示FOLLOWS或 PRECEDES以及也具有相同触发器事件和操作时间的现有触发器的名称。使用 FOLLOWS，新触发器在现有触发器之后激活。使用PRECEDES，新触发器在现有触发器之前激活。

trigger_body是触发器激活时要执行的语句。要执行多个语句，请使用 BEGIN ... END 复合语句构造。这也使您能够使用存储例程中允许的相同语句。请参阅第 13.6.1 节，“BEGIN ... END 复合语句”。触发器中不允许使用某些语句；参见第 25.8 节，“存储程序的限制”。

OLD在触发器主体中，您可以使用别名和引用主题表（与触发器关联的表）中的列 NEW。在更新或删除之前引用现有行的列。指要插入的新行或更新后的现有行的列。 OLD.col_nameNEW.col_name

触发器不能使用或用于引用生成的列。有关生成的列的信息，请参阅第 13.1.20.8 节，“CREATE TABLE 和生成的列”。 NEW.col_nameOLD.col_name

MySQLsql_mode在创建触发器时存储有效的系统变量设置，并始终执行具有此设置的触发器主体， 而不管触发器开始执行时当前服务器 SQL 模式如何。

该DEFINER子句指定在触发器激活时检查访问权限时要使用的 MySQL 帐户。如果DEFINER存在该子句，则该 user值应该是指定为、或的 MySQL 帐户。允许的值取决于您拥有的权限，如第 25.6 节“存储对象访问控制”中所述。另请参阅该部分以获取有关触发器安全性的其他信息。 'user_name'@'host_name'CURRENT_USERCURRENT_USER()user

如果DEFINER省略该子句，则默认定义者是执行该CREATE TRIGGER语句的用户。这与明确指定相同 DEFINER = CURRENT_USER。

MySQLDEFINER在检查触发器权限时会考虑用户，如下所示：

有时CREATE TRIGGER，发出该语句的用户必须具有 TRIGGER权限。
在触发器激活时，会检查 DEFINER用户的权限。此用户必须具有以下权限：
- 主题表的TRIGGER权限。
- 如果使用或在触发器主体中 SELECT引用表列，则主题表的权限。OLD.col_nameNEW.col_name
- UPDATE如果表列是触发器主体中分配的目标，则主题表的特权。SET NEW.col_name = value
- 触发器执行的语句通常需要任何其他特权。

在触发器体内，该 CURRENT_USER函数返回用于在触发器激活时检查权限的帐户。这是DEFINER用户，而不是其操作导致触发器被激活的用户。有关触发器内用户审计的信息，请参阅第 6.2.23 节，“基于 SQL 的帐户活动审计”。

如果您使用LOCK TABLES锁定具有触发器的表，则触发器中使用的表也会被锁定，如锁定表和触发器中所述。

有关触发器使用的其他讨论，请参阅第 25.3.1 节，“触发器语法和示例”。