↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 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
历史版本。 PostgreSQL 9.2 已结束支持。 2017-11-09. 请参阅 当前版本手册.

41.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";    # 跳过 INSERT/UPDATE 命令
    } 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();

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.