# CREATE EVENT TRIGGER ## Name CREATE EVENT TRIGGER?--?定義一個事件觸發器 ## Synopsis ``` CREATE EVENT TRIGGER _name_ ON _event_ [ WHEN _filter_variable_ IN (filter_value [, ... ]) [ AND ... ] ] EXECUTE PROCEDURE _function_name_() ``` ## 描述 `CREATE EVENT TRIGGER`創建一個新的事件觸發器.無論何時指定的事件發生或`WHEN`的條件滿足觸發器，觸發器函數將被執行．對于事件觸發器的一般說明，請見于[Chapter 37](#calibre_link-580). 創建事件觸發器的用戶將變為它的擁有者. ## 參數 `_name_` 一個新的觸發器的名字．這個名字必須在數據庫內是唯一的. `_event_` 觸發調用一個給定函數的事件名子.關于事件名字的更多信息見于 [Section 37.1](#calibre_link-845). `_filter_variable_` 過濾事件的變量名稱.這將限制它所支持的事件的一個子集去觸發該觸發器.現在僅支持`_filter_variable_`值為TAG. `_filter_value_` 可以觸發該觸發器的 `_filter_variable_`相關的值.對于`TAG`,這意味著一個tags的命令列表.(例如.`'DROP FUNCTION'`). `_function_name_` 一個用戶聲明的不帶參數的函數并且返回 `event_trigger`類型. ## Notes 只有超戶能創建事件觸發器. 在單用戶模式下事件觸發器是被關閉的(詳見于[postgres](#calibre_link-1033)). 如果一個錯誤的事件觸發器關閉了數據庫,在單用戶模式下你將不能重啟數據庫,刪除事件觸發器. ## Examples 禁止執行任何[DDL](#calibre_link-1570)命令: ``` CREATE OR REPLACE FUNCTION abort_any_command() RETURNS event_trigger LANGUAGE plpgsql AS $$ BEGIN RAISE EXCEPTION 'command % is disabled', tg_tag; END; $$; CREATE EVENT TRIGGER abort_ddl ON ddl_command_start EXECUTE PROCEDURE abort_any_command(); ``` ## Compatibility 在標準的SQL語法中沒有 `CREATE EVENT TRIGGER`語句. ## 相關內容 [ALTER EVENT TRIGGER](#calibre_link-60), [DROP EVENT TRIGGER](#calibre_link-571), [CREATE FUNCTION](#calibre_link-4)