43.6. PL/Perl 触发器

PL/Perl 可以被用来编写触发器函数。在触发器函数中，哈希引用 $_TD包含有关当前触发器事件的信息。 $_TD是一个全局变量，对触发器的每一次调用它都会得到一个独立的本地值。$_TD哈希引用的域有：

$_TD->{new}{foo}: 列foo的NEW值
$_TD->{old}{foo}: 列foo的OLD值
$_TD->{name}: 要被调用的触发器的名称
$_TD->{event}: 触发器事件：INSERT、UPDATE、 DELETE、TRUNCATE或者UNKNOWN
$_TD->{when}: 什么时候调用触发器：BEFORE、 AFTER、INSTEAD OF或者 UNKNOWN
$_TD->{level}: 触发器级别：ROW、STATEMENT或者UNKNOWN
$_TD->{relid}: 触发器定义在其上的表的 OID
$_TD->{table_name}: 触发器定义在其上的表的名称
$_TD->{relname}: 触发器定义在其上的表的名称。这已经被废弃，并且可能会在未来的发布中被移除。请使用 $_TD->{table_name}。
$_TD->{table_schema}: 触发器定义在其上的表所在的模式的名称
$_TD->{argc}: 触发器函数的参数数目
@{$_TD->{args}}: 触发器函数的参数。如果$_TD->{argc}为 0 则不存在

行级触发器可以返回下列之一：

return;: 执行操作
"SKIP": 不执行操作
"MODIFY": 指示触发器函数修改了NEW行

这里是一个触发器函数的例子，展示上文所说的一些东西：

CREATE TABLE test (
    i int,
    v varchar
);

CREATE OR REPLACE FUNCTION valid_id() RETURNS trigger AS $$
    if (($_TD->{new}{i} >= 100) || ($_TD->{new}{i} <= 0)) {
        return "SKIP";    # skip INSERT/UPDATE command
    } elsif ($_TD->{new}{v} ne "immortal") {
        $_TD->{new}{v} .= "(modified by trigger)";
        return "MODIFY";  # 修改行并且执行 INSERT/UPDATE 命令
    } else {
        return;           # 执行 INSERT/UPDATE 命令
    }
$$ LANGUAGE plperl;

CREATE TRIGGER test_valid_id_trig
    BEFORE INSERT OR UPDATE ON test
    FOR EACH ROW EXECUTE PROCEDURE valid_id();

PostgreSQL9.6 中文手册

43.6. PL/Perl 触发器