GaussDB数据库SQL系列-触发器

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 );

主要参数说明：

CONSTRAINT：可选项，指定此参数将创建约束触发器，即触发器作为约束来使用。除了可以使用SET CONSTRAINTS调整触发器触发的时间之外，这与常规触发器相同。约束触发器必须是AFTER ROW触发器。
trigger_name：触发器名称，该名称不能限定模式，因为触发器自动继承其所在表的模式，且同一个表的触发器不能重名。对于约束触发器，使用SET CONSTRAINTS修改触发器行为时也使用此名称。命名规范：符合标识符命名规范的字符串，且最大长度不超过63个字符。
BEFORE：触发器函数是在触发事件发生前执行。
AFTER：触发器函数是在触发事件发生后执行，约束触发器只能指定为AFTER。
INSTEAD OF：触发器函数直接替代触发事件。
event：启动触发器的事件，取值范围包括：INSERT、UPDATE、DELETE或TRUNCATE，也可以通过OR同时指定多个触发事件。
table_name：需要创建触发器的表名称。取值范围：数据库中已经存在的表名称。
referenced_table_name：约束引用的另一个表的名称。只能为约束触发器指定，常见于外键约束。由于当前不支持外键，因此不建议使用。取值范围：数据库中已经存在的表名称。
DEFERRABLE | NOT DEFERRABLE：约束触发器的启动时机，仅作用于约束触发器。这两个关键字设置该约束是否可推迟。
INITIALLY IMMEDIATE | INITIALLY DEFERRED：如果约束是可推迟的，则这个子句声明检查约束的缺省时间，仅作用于约束触发器。
FOR EACH ROW | FOR EACH STATEMENT：触发器的触发频率。FOR EACH ROW是指该触发器是受触发事件影响的每一行触发一次。FOR EACH STATEMENT是指该触发器是每个SQL语句只触发一次。未指定时默认值为FOR EACH STATEMENT。约束触发器只能指定为FOR EACH ROW。
condition：决定是否实际执行触发器函数的条件表达式。当指定WHEN时，只有在条件返回true时才会调用该函数。
function_name：用户定义的函数，必须声明为不带参数并返回类型为触发器，在触发器触发时执行。
arguments：执行触发器时要提供给函数的可选的以逗号分隔的参数列表。参数是文字字符串常量，简单的名称和数字常量也可以写在这里，但它们都将被转换为字符串。请检查触发器函数的实现语言的描述，以了解如何在函数内访问这些参数。

2、创建步骤

1）确定触发器的目的和条件：

首先，您需要确定触发器的目的和条件。这包括确定您希望在什么情况下触发触发器（例如，在插入、更新或删除数据时）以及触发器的具体条件（例如，仅在特定时间或特定用户执行操作时触发）。

2）编写触发器的代码：

根据您的需求，编写触发器的SQL代码。这可以包括SELECT、INSERT、UPDATE、DELETE等语句以及逻辑控制语句（例如IF语句）。

3）定义触发器的参数：

定义触发器的参数，例如要监控的表、触发时机（BEFORE/AFTER）、触发事件（INSERT/UPDATE/DELETE）等。

4）创建触发器：

使用CREATE TRIGGER语句创建触发器，并指定上述定义好的参数和代码。

3、注意事项

当前仅支持在普通行存表上创建触发器，不支持在列存表、临时表、unlogged表等类型表上创建触发器。
如果为同一事件定义了多个相同类型的触发器，则按触发器的名称字母顺序触发它们。
执行触发器语句时是用触发器创建者的身份进行权限判断的。
执行创建触发器操作的用户需要拥有指定表的TRIGGER权限或被授予了CREATE ANY TRIGGER权限。
触发器常用于多表间数据关联同步场景，对SQL执行性能影响较大，不建议在大数据量同步及对性能要求高的场景中使用。

4、附：表和视图上支持的触发器种类

四、GaussDB数据库中的示例

示例一、在GaussDB数据库中创建一个触发器，以便在插入新记录时自动将记录的创建时间设置为当前时间。

以下是一个简单的示例，演示了如何在GaussDB数据库中创建一个触发器，以便在插入新记录时自动将记录的创建时间设置为当前时间。

--定义一个触发器函数，用于设置创建时间字段的值：
CREATE OR REPLACE FUNCTION set_created_at()
RETURNS TRIGGER 
AS $$
BEGIN
   NEW.date = NOW();  
   RETURN NEW;
END
$$ 
LANGUAGE plpgsql;

--创建一个INSERT触发器
CREATE TRIGGER set_created_at_trigger
BEFORE INSERT ON test_1
FOR EACH ROW
EXECUTE PROCEDURE set_created_at();

--执行INSERT触发事件并检查触发结果
INSERT INTO test_1 VALUES(6,'');
SELECT * FROM test_1;

说明：

1、其中test_1为测试表，date为测试表的字段名。

2、NEW是一个特殊的关键字，代表正在插入的新记录。当一个触发器被触发时，例如在INSERT操作发生时，NEW可以用来引用正在被插入的新记录。这样，你就可以在触发器中使用NEW来引用正在进行操作的数据。

3、参数“BEFORE”、“FOR EACH ROW”等可参见上文语法参数说明。

示例二、在GaussDB数据库中创建一个触发器，当向测试表test_1中INSERT 数据的时候，同时向测试表test_2中插入相同的数据。

以下是在GaussDB数据库中创建一个触发器，当向测试表test_1中INSERT 数据的时候，触发器被触发，并向测试表test_2中插入相同的数据。

--创建触发器函数
CREATE OR REPLACE FUNCTION tri_insert_func() 
RETURNS TRIGGER 
AS $$
DECLARE
BEGIN
   INSERT INTO test_2 VALUES(NEW.id, NEW.date);
   RETURN NEW;
  END
$$ 
LANGUAGE PLPGSQL;

--创建INSERT触发器
CREATE TRIGGER insert_trigger
BEFORE INSERT ON test_1
FOR EACH ROW
EXECUTE PROCEDURE tri_insert_func();

--执行INSERT触发事件并检查触发结果
INSERT INTO test_1(id,date) VALUES(1,current_timestamp);

SELECT *, 'test_1' as table_n FROM test_1
UNION ALL
SELECT *, 'test_2' as table_n FROM test_2;

CREATE TRIGGER_云数据库 GaussDB_分布式_3.x版本_SQL参考_SQL语法_华为云

五、小结

GaussDB数据库中的触发器是一种强大的工具，可用于自动化数据处理、数据验证、日志记录等任务。通过使用触发器，您可以提高数据一致性、减少数据冗余、实施业务规则并增强数据安全性。本文介绍了GaussDB数据库中触发器的基本概念、创建步骤和示例。希望能够帮助您更好地了解和使用GaussDB中的触发器功能。

——结束