功能描述
创建一个触发器。触发器将与指定的表或视图关联，
并在特定条件下执行指定的函数。
注意事项
当前仅支持在普通行存表上创建触发器，不支持在列存表、临时表、unlogged 表等类型
表上创建触发器。
如果为同一事件定义了多个相同类型的触发器，则按触发器的名称字母顺序触发它们。
触发器常用于多表间数据关联同步场景，对SQL 执行性能影响较大，不建议在大数据
量同步及对性能要求高的场景中使用。
语法格式
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
1067
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 );
其中event 包含以下几种：
INSERT
UPDATE [ OF column_name [, ... ] ]
DELETE
TRUNCATE
参数说明
CONSTRAINT
可选项，指定此参数将创建约束触发器，
即触发器作为约束来使用。
除了可以使用SET
CONSTRAINTS 调整触发器触发的时间之外，这与常规触发器相同。约束触发器必须是
AFTER ROW 触发器。
trigger_name
触发器名称，该名称不能限定模式，
因为触发器自动继承其所在表的模式，且同一个表
的触发器不能重名。对于约束触发器，
使用SET CONSTRAINTS 修改触发器行为时也使用
此名称。
取值范围：符合标识符命名规范的字符串，且最大长度不超过63 个字符。
BEFORE
触发器函数是在触发事件发生前执行。
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
1068
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。
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
1069
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
执行触发器时要提供给函数的可选的以逗号分隔的参数列表。参数是文字字符串常量，
简单的名称和数字常量也可以写在这里，但它们都将被转换为字符串。请检查触发器函数
的实现语言的描述，以了解如何在函数内访问这些参数。
说明：关于触发器种类：
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
1070
INSTEAD OF 的触发器必须标记为FOR EACH ROW，并且只能在视图上定义。
BEFORE 和AFTER 触发器作用在视图上时，只能标记为FOR EACH STATEMENT。
TRUNCATE 类型触发器仅限FOR EACH STATEMENT。
表1 表和视图上支持的触发器种类：
触发时机
触发事件
行级
语句级
BEFORE
INSERT/UPDATE/DELET
E
表
表和视图
TRUNCATE
不支持
表
AFTER
INSERT/UPDATE/DELET
E
表
表和视图
TRUNCATE
不支持
表
INSTEAD O
F
INSERT/UPDATE/DELET
E
视图
不支持
TRUNCATE
不支持
不支持
表2 PLPGSQL 类型触发器函数特殊变量：
变量名
变量含义
NEW
INSERT 及UPDATE 操作涉及tuple 信息中
的新值，对DELETE 为空。
OLD
UPDATE 及DELETE 操作涉及tuple 信息中
的旧值，对INSERT 为空。
TG_NAME
触发器名称。
TG_WHEN
触发器触发时机
（BEFORE/AFTER/INSTEA
D OF）。
TG_LEVEL
触发频率（ROW/STATEMENT）。
TG_OP
触发操作（INSERT/UPDATE/DELETE/TRU
NCATE）。
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
1071
变量名
变量含义
TG_RELID
触发器所在表OID。
TG_RELNAME
触发器所在表名（已废弃，现用TG_TABL
E_NAME 替代）。
TG_TABLE_NAME
触发器所在表名。
TG_TABLE_SCHEMA
触发器所在表的SCHEMA 信息。
TG_NARGS
触发器函数参数个数。
TG_ARGV[]
触发器函数参数列表。
示例
--创建源表及触发表
gbase=#CREATE TABLE test_trigger_src_tbl(id1 INT, id2 INT, id3 INT);
gbase=#CREATE TABLE test_trigger_des_tbl(id1 INT, id2 INT, id3 INT);
--创建触发器函数
gbase=#CREATE OR REPLACE FUNCTION tri_insert_func() RETURNS TRIGGER AS
$$
DECLARE
BEGIN
INSERT INTO test_trigger_des_tbl VALUES(NEW.id1, NEW.id2,
NEW.id3);
RETURN NEW;
END
$$ LANGUAGE PLPGSQL;
gbase=#CREATE OR REPLACE FUNCTION tri_update_func() RETURNS TRIGGER AS
$$
DECLARE
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
1072
BEGIN
UPDATE test_trigger_des_tbl SET id3 = NEW.id3 WHERE
id1=OLD.id1;
RETURN OLD;
END
$$ LANGUAGE PLPGSQL;
gbase=#CREATE OR REPLACE FUNCTION TRI_DELETE_FUNC() RETURNS TRIGGER AS
$$
DECLARE
BEGIN
DELETE FROM test_trigger_des_tbl WHERE id1=OLD.id1;
RETURN OLD;
END
$$ LANGUAGE PLPGSQL;
--创建INSERT 触发器
gbase=#CREATE TRIGGER insert_trigger
BEFORE INSERT ON test_trigger_src_tbl
FOR EACH ROW
EXECUTE PROCEDURE tri_insert_func();
--创建UPDATE 触发器
gbase=#CREATE TRIGGER update_trigger
AFTER UPDATE ON test_trigger_src_tbl
FOR EACH ROW
EXECUTE PROCEDURE tri_update_func();
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
1073
--创建DELETE 触发器
gbase=#CREATE TRIGGER delete_trigger
BEFORE DELETE ON test_trigger_src_tbl
FOR EACH ROW
EXECUTE PROCEDURE tri_delete_func();
--执行INSERT 触发事件并检查触发结果
gbase=#INSERT INTO test_trigger_src_tbl VALUES(100,200,300);
gbase=#SELECT * FROM test_trigger_src_tbl;
gbase=#SELECT * FROM test_trigger_des_tbl;
//查看触发操作是否生效。
--执行UPDATE 触发事件并检查触发结果
gbase=#UPDATE test_trigger_src_tbl SET id3=400 WHERE id1=100;
gbase=#SELECT * FROM test_trigger_src_tbl;
gbase=#SELECT * FROM test_trigger_des_tbl;
//查看触发操作是否生效
--执行DELETE 触发事件并检查触发结果
gbase=#DELETE FROM test_trigger_src_tbl WHERE id1=100;
gbase=#SELECT * FROM test_trigger_src_tbl;
gbase=#SELECT * FROM test_trigger_des_tbl;
//查看触发操作是否生效
--修改触发器
gbase=#ALTER TRIGGER delete_trigger ON test_trigger_src_tbl RENAME TO
delete_trigger_renamed;
--禁用insert_trigger 触发器
gbase=#ALTER TABLE test_trigger_src_tbl DISABLE TRIGGER insert_trigger;
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
1074
--禁用当前表上所有触发器
gbase=#ALTER TABLE test_trigger_src_tbl DISABLE TRIGGER ALL;
--删除触发器
gbase=#DROP TRIGGER insert_trigger ON test_trigger_src_tbl;
gbase=#DROP TRIGGER update_trigger ON test_trigger_src_tbl;
gbase=#DROP TRIGGER delete_trigger_renamed ON test_trigger_src_tbl;
相关命令
ALTER TRIGGER，DROP TRIGGER，ALTER TABLE