openGauss SQL参考—SQL语法：CREATE TRIGGER（2）

参数说明

• CONSTRAINT

  可选项，指定此参数将创建约束触发器，即触发器作为约束来使用。除了可以使用SET CONSTRAINTS调整触发器触发的时间之外，这与常规触发器相同。 约束触发器必须是AFTER ROW触发器。

• DEFINER

  可选项，指定此参数可以影响触发器内引用对象的权限控制。

• IF NOT EXISTS

  可选项，指定此参数如果触发器在相同的模式中具有相同的名称、相同的表、相同的表，则防止发生错误。

• trigger_name

  触发器名称，该名称在mysql兼容风格语法中可以指定模式，触发器模式必须与其所在表的模式相同，若不限定模式，触发器自动继承其所在表的模式，同一个表的触发器不能重名。对于约束触发器，使用SET CONSTRAINTS修改触发器行为时也使用此名称。

  取值范围：符合标识符命名规范的字符串，且最大长度不超过63个字符。

• BEFORE

  触发器函数是在触发事件发生前执行。

• AFTER

  触发器函数是在触发事件发生后执行，约束触发器只能指定为AFTER。

• INSTEAD OF

  触发器函数直接替代触发事件。

• event

  启动触发器的事件，取值范围包括：INSERT、UPDATE、DELETE或TRUNCATE，也可以通过OR同时指定多个触发事件。

  对于UPDATE事件类型，可以使用下面语法指定列：

  UPDATE OF column_name1 [, column_name2 ... ]
  

  表示当这些列作为UPDATE语句的目标列时，才会启动触发器，但是INSTEAD OF UPDATE类型不支持指定列信息。如果UPDATE OF指定的列包含生成列，当生成列依赖的列是UPDATE语句的目标列时，也会启动触发器。

• table_name

  需要创建触发器的表名称。

  取值范围：数据库中已经存在的表名称。

• referenced_table_name

  约束引用的另一个表的名称。 只能为约束触发器指定，常见于外键约束。

  取值范围：数据库中已经存在的表名称。

• DEFERRABLE | NOT DEFERRABLE

  约束触发器的启动时机，仅作用于约束触发器。这两个关键字设置该约束是否可推迟。

  详细介绍请参见CREATE TABLE。

• INITIALLY IMMEDIATE | INITIALLY DEFERRED

  如果约束是可推迟的，则这个子句声明检查约束的缺省时间，仅作用于约束触发器。

  详细介绍请参见CREATE TABLE。

• FOR EACH ROW | FOR EACH STATEMENT

  触发器的触发频率。

  • FOR EACH ROW是指该触发器是受触发事件影响的每一行触发一次。
  • FOR EACH STATEMENT是指该触发器是每个SQL语句只触发一次。

  未指定时默认值为FOR EACH STATEMENT。约束触发器只能指定为FOR EACH ROW。

• condition

  决定是否实际执行触发器函数的条件表达式。当指定WHEN时，只有在条件返回true时才会调用该函数。

  在FOR EACH ROW触发器中，WHEN条件可以通过分别写入OLD.column_name或NEW.column_name来引用旧行或新行值的列。 当然，INSERT触发器不能引用OLD和DELETE触发器不能引用NEW。

  INSTEAD OF触发器不支持WHEN条件。

  WHEN表达式不能包含子查询。

  对于约束触发器，WHEN条件的评估不会延迟，而是在执行更新操作后立即发生。 如果条件返回值不为true，则触发器不会排队等待延迟执行。

• function_name

  用户定义的函数，必须声明为不带参数并返回类型为触发器，在触发器触发时执行。

• arguments

  执行触发器时要提供给函数的可选的以逗号分隔的参数列表。参数是文字字符串常量，简单的名称和数字常量也可以写在这里，但它们都将被转换为字符串。 请检查触发器函数的实现语言的描述，以了解如何在函数内访问这些参数。

• trigger_order

  可选项，trigger_order特征中的{FOLLOWS|PRECEDES}控制触发器的优先触发顺序，mysql兼容性模式下允许对同一个表，在同一触发事件定义多个触发器，会按照触发器创建的先后顺序来决定触发的优先顺序（先创建的优先）。可以通过{FOLLOWS|PRECEDES}来调整优先级。使用FOLLOWS，最后一次使用的触发器与原始触发器最紧挨着，其他的触发器的优先级都顺序向后挤压；使用PRECEDES，最后一次使用的触发器与原始触发器最紧挨着，其他的触发器的优先级都顺序向前挤压。

• trigger_body

  直接通过在begin…end之间书写代码块，定义触发器之后要完成的工作。

  表 1 表和视图上支持的触发器种类：

   说明：

  关于触发器种类：

  • INSTEAD OF的触发器必须标记为FOR EACH ROW，并且只能在视图上定义。
  • BEFORE和AFTER触发器作用在视图上时，只能标记为FOR EACH STATEMENT。
  • TRUNCATE类型触发器仅限FOR EACH STATEMENT。