2024 年 9 月 26 日: PostgreSQL 17 发布!
支持版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不受支持的版本: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

43.6. PL/Perl 触发器 #

PL/Perl 可用于编写触发器函数。在触发器函数中,哈希引用 $_TD 包含有关当前触发器事件的信息。 $_TD 是一个全局变量,每个触发器调用都会获得一个独立的局部值。 $_TD 哈希引用的字段如下

$_TD->{new}{foo}

NEW 值为列 foo

$_TD->{old}{foo}

OLD 值为列 foo

$_TD->{name}

正在调用的触发器名称

$_TD->{event}

触发器事件:INSERTUPDATEDELETETRUNCATEUNKNOWN

$_TD->{when}

触发器调用的时间:BEFOREAFTERINSTEAD OFUNKNOWN

$_TD->{level}

触发器级别:ROWSTATEMENTUNKNOWN

$_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();

提交更正

如果您在文档中看到任何不正确的内容,不符合您对特定功能的体验或需要进一步说明,请使用 此表格 报告文档问题。