PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

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";  # modify row and execute INSERT/UPDATE command
    } else {
        return;           # execute INSERT/UPDATE command
    }
$$ LANGUAGE plperl;

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