数据仓库服务 GAUSSDB(DWS)-CREATE TRIGGER:参数说明
参数说明
- CONSTRAINT
可选项,指定此参数将创建约束触发器,即触发器作为约束来使用。除了可以使用SET CONSTRAINTS调整触发器触发的时间之外,这与常规触发器相同。 约束触发器必须是AFTER ROW触发器。
- trigger_name
触发器名称,该名称不能限定模式,因为触发器自动继承其所在表的模式,且同一个表的触发器不能重名。 对于约束触发器,使用SET CONSTRAINTS修改触发器行为时也使用此名称。
取值范围:符合标识符命名规范的字符串,且最大长度不超过63个字符。
- BEFORE
触发器函数是在触发事件发生前执行。
- AFTER
触发器函数是在触发事件发生后执行,约束触发器只能指定为AFTER。
- INSTEAD OF
触发器函数直接替代触发事件。
- event
启动触发器的事件,取值范围包括:INSERT、UPDATE、DELETE或TRUNCATE,也可以通过OR同时指定多个触发事件。
对于UPDATE事件类型,可以使用下面语法指定列:
1
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
执行触发器时要提供给函数的可选的以逗号分隔的参数列表。参数是文字字符串常量,简单的名称和数字常量也可以写在这里,但它们都将被转换为字符串。 请检查触发器函数的实现语言的描述,以了解如何在函数内访问这些参数。
关于触发器种类:
- INSTEAD OF的触发器必须标记为FOR EACH ROW,并且只能在视图上定义。
- BEFORE和AFTER触发器作用在视图上时,只能标记为FOR EACH STATEMENT。
- TRUNCATE类型触发器仅限FOR EACH STATEMENT。
表1 表和视图上支持的触发器种类: 触发时机
触发事件
行级
语句级
BEFORE
INSERT/UPDATE/DELETE
表
表和视图
TRUNCATE
不支持
表
AFTER
INSERT/UPDATE/DELETE
表
表和视图
TRUNCATE
不支持
表
INSTEAD OF
INSERT/UPDATE/DELETE
视图
不支持
TRUNCATE
不支持
不支持
表2 PLPGSQL类型触发器函数特殊变量: 变量名
变量含义
NEW
INSERT及UPDATE操作涉及tuple信息中的新值,对DELETE为空。
OLD
UPDATE及DELETE操作涉及tuple信息中的旧值,对INSERT为空。
TG_NAME
触发器名称。
TG_WHEN
触发器触发时机(BEFORE/AFTER/INSTEAD OF)。
TG_LEVEL
触发频率(ROW/STATEMENT)。
TG_OP
触发操作(INSERT/UPDATE/DELETE/TRUNCATE)。
TG_RELID
触发器所在表OID。
TG_RELNAME
触发器所在表名(已废弃,现用TG_TABLE_NAME替代)。
TG_TABLE_NAME
触发器所在表名。
TG_TABLE_SCHEMA
触发器所在表的SCHEMA信息。
TG_NARGS
触发器函数参数个数。
TG_ARGV[]
触发器函数参数列表。
- 数据仓库服务GaussDB(DWS)_SQL on Anywhere
- DWS安全_数据仓库服务安全_DWS数据安全管理_DWS安全保障_DWS安全策略
- 调用GaussDB(DWS) API接口_数据仓库服务调用API_如何调用API_在DWS中调用API
- GaussDB(DWS)常用SQL_常用SQL命令_SQL语法
- DWS资源管理_GaussDB(DWS)资源管理作用_DWS资源管控
- GAUSS(DWS)工具_gsql工具_DataStudio工具_DSC工具
- DWS产品介绍_DWS产品优势_DWS功能_DWS使用场景_DWS是什么
- GaussDB数据库SQL语法_SQL语法_CREATE_ALTER
- 如何进行日志采集和转储_日志平台_日志接入_日志转储
- 数据库监控DMS_数据库智能运维_了解Auto Pilot_DMS_DWS节点监控