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

SYNOPSIS

 

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

DESCRIPTION 描述

CREATE TRIGGER 建立一個新的觸發器。 觸發器將與指定表關聯而且將在特定事件發生時執行聲明的函數 func。

 觸發器能夠聲明爲在對記錄進行操做以前（在檢查約束以前和 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 ``Triggers'' 獲取更多信息。

PARAMETERS 參數

name

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

BEFORE

AFTER

 決定該函數是在事件以前仍是以後調用。

event

INSERT，DELETE 或 UPDATE 其中之一。 它聲明擊發觸發器的事件。多個事件能夠用 OR 聲明。

table

觸發器做用的表名稱（能夠用模式修飾）。

FOR EACH ROW

FOR EACH STATEMENT

 這些選項聲明觸發器過程是否爲觸發器事件影響的每一個行觸發一次， 仍是隻爲每條 SQL 語句觸發一次。若是都沒有聲明， FOR EACH STATEMENT 是缺省。

func

一個用戶提供的函數，它聲明爲不接受參數而且返回 trigger 類型。

arguments

 一個可選的用逗號分隔的參數列表，它將在觸發器執行的時候提供給函數， 這些參數是文本字串常量。也能夠在這裏寫簡單的名字和數值常量，可是它們會被轉換成字串。 請檢查實現語言中關於如何在觸發器函數中訪問觸發器參數的描述； 這些參數可能和普通的函數參數不一樣。

NOTES 注意

 要在一個表上建立一個觸發器，用戶必需在該表上有 TRIGGER 權限。

 在 PostgreSQL 版本 7.3 之前， 咱們必須把觸發器函數聲明爲返回佔位類型 opaque， 而不是 trigger。爲了支持裝載老的轉儲文件， CREATE TRIGGER 將接受一個聲明爲返回 opaque 的函數， 可是它將發出一條 NOTICE 而且把函數聲明的返回類型改爲 trigger。

 用 DROP TRIGGER [drop_trigger(7)] 獲取如何刪除觸發器的信息。

EXAMPLES 例子

Section 33.4 ``Triggers'' 包含一個完整的例子。

COMPATIBILITY 兼容性

CREATE TRIGGER 裏的 CREATE TRIGGER 語句實現了一個 SQL99 標準的子集。 （SQL92 裏沒有觸發器） 目前仍然缺乏下面的功能∶

*

SQL99 容許觸發器爲指定的字段的更新進行觸發（也就是說，AFTER UPDATE OF col1, col2）。

*

SQL99 容許你爲 "old" 和 "new" 行或者表定義別名，用於定義觸發器的動做（也就是說， CREATE TRIGGER ... ON tablename REFERENCING OLD ROW AS somename NEW ROW AS othername ...)。由於 PostgreSQL 容許觸發器過程以任意數量的用戶定義語言進行書寫，因此訪問數據的工做是用和語言相關的方法實現的。

*

PostgreSQL 只容許爲觸發的動做執行存儲的過程。SQL99 容許執行一些其餘的 SQL 命令， 好比那 CREATE TABLE 做爲觸發器動做。 這個限止並不難繞開，只要建立一個執行這些命令的存儲過程便可。

 

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

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