pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
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();
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。