45.6. PL/Perl 触发器 #
PL/Perl 可用于编写触发器函数。在触发器函数中,hash 引用
$_TD 包含有关当前触发器事件的信息。$_TD 是一个全局变量,对触发器的每一次调用都会得到一个单独的局部值。$_TD hash 引用包含以下字段:
$_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,则该字段不存在
行级触发器可以返回下列之一:
下面是一个触发器函数示例,用于说明上述部分内容:
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 FUNCTION valid_id();
报告文档问题
阅读 上游文档. 通过 PostgreSQL 文档反馈表单.