PostgreSQL 8.0.0 中文文件（轉譯自 PostgreSQL 中國 製作的簡體中文版本）
PrevFast BackwardFast ForwardNext

CREATE TRIGGER

Name

CREATE TRIGGER -- 定義一個新的觸發器

Synopsis

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 操作）觸發。 如果觸發器在事件之前，觸發器可能略過目前記錄的操作或改變被插入的（目前）記錄（只對 INSERT 和 UPDATE 操作有效）。 如果觸發器在事件之後，所有更改，包括最後的插入， 更新或刪除對觸發器都是"可見"的。

一個 FOR EACH ROW 執行指定操作的觸發器為操作修改的每一行都調用一次。比如，一個影響 10 行的 DELETE 將導致任何在目標關係上的 ON DELETE 觸發器獨立調用 10 次， 每個被刪除的行一次。相比之下，一個為指定操作 FOR EACH STATEMENT 的觸發器只是為任何操作執行一次，不管有多少行被修改。 （特別是，一個修改零行的操作仍然會導致任何合適的 FOR EACH STATEMENT 觸發器的執行。）

如果多個同類型的觸發器為同樣事件做了定義， 那麼它們將按照字母順序被激活。

SELECT 並不更改任何行，因此您不能建立 SELECT 觸發器。這種場合下規則和視圖更合適些。

請參考 Part V 獲取更多訊息。

參數

name

賦予新觸發器的名稱。它必需和任何作用於同一資料表的觸發器不同。

BEFORE
AFTER

決定該函數是在事件之前還是之後調用。

event

INSERT，DELETE 或 UPDATE 其中之一。 它聲明擊發觸發器的事件。多個事件可以用 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 獲取如何刪除觸發器的訊息。

例子

Section 32.4 包含一個完整的例子。

相容性

PostgreSQL 裡的 CREATE TRIGGER 語句實現了一個 SQL:1999 標準的子集。 （SQL-92 裡沒有觸發器） 目前仍然缺少下面的功能︰

SQL:1999 要求多個觸發器應該以建立的時間順序執行。 PostgreSQL 採用的是按照名字順序， 我們認為這樣更加方便。

用 OR 給一個觸發器聲明多個動作是 PostgreSQL 對標準的擴展。

又見

CREATE FUNCTION, ALTER TRIGGER, DROP TRIGGER
PrevHomeNext
CREATE TABLESPACEUpCREATE TYPE