PostgreSQL 8.2.3 中文文档
后退快退快进前进

CREATE TRIGGER

名称

CREATE TRIGGER -- 定义一个新触发器

语法

CREATE TRIGGER name { BEFORE | AFTER } { event [ OR ... ] }
    ON table [ FOR [ EACH ] { ROW | STATEMENT } ]
    EXECUTE PROCEDURE funcname ( arguments )

描述

CREATE TRIGGER 创建一个新的触发器。触发器将与指定表关联并且将在特定事件发生时执行声明的 funcname 函数。

触发器可以声明为在对记录进行操作之前(在检查约束之前和 INSERT, UPDATE, DELETE 执行前)或操作完成之后(在检查约束之后和完成 INSERT, UPDATE, DELETE 操作)触发。如果触发器在事件之前,触发器可能略过当前记录的操作或改变被插入的记录(只对 INSERTUPDATE 操作有效)。如果触发器在事件之后,所有更改,包括最后的插入、更新、删除对触发器都是"可见"的。

一个被标记为 FOR EACH ROW 的触发器为操作修改的每一行都调用一次。比如,一个影响 10 行的 DELETE 将导致任何在目标关系上的 ON DELETE 触发器独立调用 10 次,每个被删除的行调用一次。相比之下,一个被标记为 FOR EACH STATEMENT 的触发器只执行一次,而不管有多少行被修改。特别是,一个修改零行的操作仍然会导致合适的 FOR EACH STATEMENT 触发器被执行。

如果多个同类型的触发器为同一事件做了定义,那么它们将按照字母顺序被触发。

SELECT 并不更改任何行,因此你不能创建 SELECT 触发器。这种场合下规则和视图更合适些。

请参考章34获取更多触发器信息。

参数

name

赋予新触发器的名称。它必需和任何作用于同一表的触发器不同。

BEFORE
AFTER

决定该函数是在事件之前还是之后调用。

event

INSERT, UPDATE, DELETE 之一。它声明击发触发器的事件。多个事件可以用 OR 声明。

table

触发器作用的表名称(可以用模式修饰)

FOR EACH ROW
FOR EACH STATEMENT

这些选项声明触发器过程是否为触发器事件影响的每个行触发一次,还是只为每条 SQL 语句触发一次。如果都没有声明,那么 FOR EACH STATEMENT 将是缺省。

funcname

一个用户提供的函数,它声明为不接受参数并且返回 trigger 类型,该函数将在触发器被触发时调用。

arguments

一个可选的用逗号分隔的参数列表,它将在触发器执行的时候提供给函数。这些参数是文本字符串常量。也可以在这里写简单的名字和数值常量,但是它们会被转换成字符串。请检查实现语言中关于如何在触发器函数中访问触发器参数的描述;这些参数可能和普通的函数参数不同。

注意

要在表上创建一个触发器,用户必需在该表上有 TRIGGER 权限。

在 PostgreSQL 7.3 以前,必须把触发器函数声明为返回 opaque 占位类型,而不是 trigger 类型。为了支持加载老的转储文件,CREATE TRIGGER 将接受一个声明为返回 opaque 的函数,但是它将发出一条 NOTICE 并且把函数声明的返回类型改成 trigger

DROP TRIGGER 删除一个触发器。

例子

节34.4包含一个完整的例子。

兼容性

PostgreSQL 里的 CREATE TRIGGER 语句实现了一个 SQL 标准的子集。目前仍然缺少下面的功能:

SQL 要求多个触发器应该以创建的时间顺序执行。PostgreSQL 采用的是按照名字顺序,并认为这样更加方便。

SQL 要求必须在级联 DELETE 完成之后再触发级联删除上的 BEFORE DELETE 触发器。PostgreSQL 的行为是 BEFORE DELETE 将永远在删除动作之前触发,即使对于级联删除也是如此,我们认为这样更一致。当 BEFORE 触发器修改随后将要被有关动作修改的行的时候,仍然存在不可预知的行为。这将导致违反约束或者存储不符合参照完整性的数据。

OR 给一个触发器声明多个动作是 PostgreSQL 对标准的扩展。

又见

CREATE FUNCTION, ALTER TRIGGER, DROP TRIGGER

后退首页前进
CREATE TABLESPACE上一级CREATE TYPE