CREATE TRIGGER
功能描述
-
创建一个触发器。 触发器将与指定的表或视图关联,并在特定条件下执行指定的函数。
-
对比原始openGauss语法,新增了使用MySQL 的格式创建触发器的语法。
-
新增了使用单条sql创建触发器的语法。
注意事项
- 当前仅支持在普通行存表上创建触发器,不支持在列存表、临时表、unlogged表等类型表上创建触发器。
- 如果为同一事件定义了多个相同类型的触发器,则按触发器的名称字母顺序触发它们。
- 触发器常用于多表间数据关联同步场景,对SQL执行性能影响较大,不建议在大数据量同步及对性能要求高的场景中使用。
- 执行创建触发器操作的用户需要拥有指定表的TRIGGER权限或被授予了CREATE ANY TRIGGER权限。
- 当使用WHEN ( condition )时,此处的括号不能省略,condition需要被括号括起。
语法格式
- o风格创建触发器的语法
CREATE [ CONSTRAINT ] TRIGGER trigger_name { BEFORE | AFTER | INSTEAD OF } { event [ OR ... ] }
ON table_name
[ FROM referenced_table_name ]
{ NOT DEFERRABLE | [ DEFERRABLE ] { INITIALLY IMMEDIATE | INITIALLY DEFERRED } }
[ FOR [ EACH ] { ROW | STATEMENT } ]
[ WHEN ( condition ) ]
EXECUTE PROCEDURE function_name ( arguments );
- 兼容mysql兼容风格的创建触发器的语法
CREATE [ CONSTRAINT ] [ DEFINER=user ] TRIGGER [ IF NOT EXISTS ] trigger_name { BEFORE | AFTER | INSTEAD OF } { event [ OR ... ] }
ON table_name
[ FROM referenced_table_name ]
{ NOT DEFERRABLE | [ DEFERRABLE ] { INITIALLY IMMEDIATE | INITIALLY DEFERRED } }
[ FOR [ EACH ] { ROW | STATEMENT } ]
[ WHEN ( condition ) ]
[ trigger_order ]
trigger_body
其中event包含以下几种:
INSERT
UPDATE [ OF column_name [, ... ] ]
DELETE
TRUNCATE
其中trigger_order是:
{ FOLLOWS|PRECEDES } other_trigger_name
参数说明
-
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类型不支持指定列信息。
-
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}控制触发器的优先触发顺序,B兼容性模式下允许对同一个表,在同一触发事件定义多个触发器,会按照触发器创建的先后顺序来决定触发的优先顺序(先创建的优先)。可以通过{FOLLOWS|PRECEDES}来调整优先级。使用FOLLOWS,最后一次使用的触发器与原始触发器最紧挨着,其他的触发器的优先级都顺序向后挤压;使用PRECEDES,最后一次使用的触发器与原始触发器最紧挨着,其他的触发器的优先级都顺序向前挤压。
-
trigger_body
直接通过在begin…end之间书写代码块,定义触发器之后要完成的工作。
也可以是单条sql语句,目前支持的语句:insert、update、delete、set、call。
当设置了分隔符后,使用MySQL 风格的创建触发器的语法,trigger_body 的格式是按照MySQL 的格式规定书写的,declare 段落需要写在begin … end段落之间。
说明:
关于触发器种类:
- INSTEAD OF的触发器必须标记为FOR EACH ROW,并且只能在视图上定义。
- BEFORE和AFTER触发器作用在视图上时,只能标记为FOR EACH STATEMENT。
- TRUNCATE类型触发器仅限FOR EACH STATEMENT。
表 1 表和视图上支持的触发器种类:
表 2 PLPGSQL类型触发器函数特殊变量: