Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17

38.4. 一个完整的事件触发器示例 #

这是一个使用 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 命令不会受到事件触发器的影响。)