↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1
历史版本PostgreSQL 7.2 已于 2007 年 2 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

23.9. 触发器过程 #

PL/pgSQL可以用来定义触发器过程。触发器 过程用CREATE FUNCTION命令创建,是一个没有 参数、返回类型为OPAQUE的函数。注意即使函数期望 接收CREATE TRIGGER中指定的参数,它也必须被 声明为没有参数——触发器参数通过TG_ARGV传递, 如下所述。

当一个PL/pgSQL函数作为触发器被调用时, 顶层块中会自动创建几个特殊变量。它们是:

NEW

数据类型RECORD;在行级触发器中保存 INSERT/UPDATE 操作的新数据库行的变量。

OLD

数据类型RECORD;在行级触发器中保存 UPDATE/DELETE 操作的旧数据库行的变量。

TG_NAME

数据类型name;包含实际被触发的触发器名字的 变量。

TG_WHEN

数据类型text;依据触发器定义而是 BEFORE或AFTER 之一的字符串。

TG_LEVEL

数据类型text;依据触发器定义而是 ROW或STATEMENT 之一的字符串。

TG_OP

数据类型text; INSERT、UPDATE 或DELETE之一的字符串,指出触发器是 为哪个操作而触发。

TG_RELID

数据类型oid;导致触发器调用的表的对象 ID。

TG_RELNAME

数据类型name;导致触发器调用的表的名字。

TG_NARGS

数据类型integer;CREATE TRIGGER 语句中给触发器过程的参数个数。

TG_ARGV[]

text类型的数组;来自CREATE TRIGGER 语句的参数。索引从 0 开始计数并且可以用表达式给出。无效的 索引(< 0 或 >= tg_nargs)得到 NULL 值。

触发器函数必须返回 NULL,或者返回一个与触发该触发器的表的 结构完全相同的记录/行值。BEFORE 触发器可以返回 NULL 来通知 触发器管理器跳过这一行操作的其余部分(即不再触发后续触发器, 而且这一行的 INSERT/UPDATE/DELETE 不会发生)。如果返回的是 非 NULL 值,操作就会以那个行值继续进行。注意返回一个与 NEW 的原始值不同的行值会改变将被插入或更新的行。可以直接在 NEW 中替换单个值然后返回它,也可以构造一个完整的新记录/行来返回。

AFTER 触发器的返回值会被忽略;它总是返回 NULL 值也无妨。但 AFTER 触发器仍然可以通过引发错误来中止操作。

例 23.1. 一个PL/pgSQL触发器过程示例

这个示例触发器保证每当表中有行被插入或更新时,当前的用户名 和时间都会被盖章到该行中。而且它还保证给出了员工的名字并且 薪水是一个正值。

CREATE TABLE emp (
    empname text,
    salary integer,
    last_date timestamp,
    last_user text
);

CREATE FUNCTION emp_stamp () RETURNS OPAQUE AS '
    BEGIN
        -- Check that empname and salary are given
        IF NEW.empname ISNULL THEN
            RAISE EXCEPTION ''empname cannot be NULL value'';
        END IF;
        IF NEW.salary ISNULL THEN
            RAISE EXCEPTION ''% cannot have NULL salary'', NEW.empname;
        END IF;

        -- Who works for us when she must pay for?
        IF NEW.salary < 0 THEN
            RAISE EXCEPTION ''% cannot have a negative salary'', NEW.empname;
        END IF;

        -- Remember who changed the payroll when
        NEW.last_date := ''now'';
        NEW.last_user := current_user;
        RETURN NEW;
    END;
' LANGUAGE 'plpgsql';

CREATE TRIGGER emp_stamp BEFORE INSERT OR UPDATE ON emp
    FOR EACH ROW EXECUTE PROCEDURE emp_stamp();

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。