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

NAME

       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  對標準的擴充套件。

譯者

       Postgresql 中文網站 何偉平 <laser@pgsqldb.org>

跋

       本頁面中文版由中文 man 手冊頁計劃提供。
       中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh

NAME

SYNOPSIS

DESCRIPTION 描述

PARAMETERS 引數

NOTES 注意

EXAMPLES 例子

COMPATIBILITY 相容性

SEE ALSO 參見

譯者

跋