2025年9月25日: PostgreSQL 18 釋出!
支援的版本: 當前 (18) / 17 / 16 / 15 / 14 / 13
開發版本: devel
不支援的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3

38.3. 一個完整的事件觸發器示例 #

下面是一個用 C 語言編寫的非常簡單的事件觸發器函式。 (在過程語言的文件中可以找到用過程語言編寫的觸發器示例。)

函式 noddl 每次被呼叫時都會引發一個異常。事件觸發器定義將該函式與 ddl_command_start 事件關聯起來。其效果是阻止所有 DDL 命令執行 (除了在 第 38.1 節 中提到的例外情況)。

這是觸發器函式的原始碼

#include "postgres.h"

#include "commands/event_trigger.h"
#include "fmgr.h"

PG_MODULE_MAGIC;

PG_FUNCTION_INFO_V1(noddl);

Datum
noddl(PG_FUNCTION_ARGS)
{
    EventTriggerData *trigdata;

    if (!CALLED_AS_EVENT_TRIGGER(fcinfo))  /* internal error */
        elog(ERROR, "not fired by event trigger manager");

    trigdata = (EventTriggerData *) fcinfo->context;

    ereport(ERROR,
            (errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
             errmsg("command \"%s\" denied",
                    GetCommandTagName(trigdata->tag))));

    PG_RETURN_NULL();
}

在編譯原始碼後 (參見 第 36.10.5 節),宣告函式和觸發器

CREATE FUNCTION noddl() RETURNS event_trigger
    AS 'noddl' LANGUAGE C;

CREATE EVENT TRIGGER noddl ON ddl_command_start
    EXECUTE FUNCTION noddl();

現在你可以測試觸發器的執行情況了

=# \dy
                     List of event triggers
 Name  |       Event       | Owner | Enabled | Function | Tags
-------+-------------------+-------+---------+----------+------
 noddl | ddl_command_start | dim   | enabled | noddl    |
(1 row)

=# CREATE TABLE foo(id serial);
ERROR:  command "CREATE TABLE" denied

在這種情況下,為了能夠在需要時執行某些 DDL 命令,你需要刪除該事件觸發器或停用它。在事務期間僅停用觸發器可能更方便

BEGIN;
ALTER EVENT TRIGGER noddl DISABLE;
CREATE TABLE foo (id serial);
ALTER EVENT TRIGGER noddl ENABLE;
COMMIT;

(請記住,事件觸發器本身上的 DDL 命令不受事件觸發器的影響。)

提交更正

如果您在文件中發現任何不正確之處,與您對特定功能的體驗不符,或者需要進一步澄清,請使用 此表單 來報告文件問題。