37.4. 一个完整的事件触发器实例

这里有一个用 C 编写的事件触发器函数的非常简单的例子(用过程语言编写的触发器的例子可以在过程语言的文档中找到)。

函数noddl在每次被调用时会抛出一个异常。该事件触发器定义将该函数与ddl_command_start事件关联在一起。其效果是所有 DDL 命令(带有Section 37.1中提到的异常)都会被阻止运行。

这是该触发器函数的源代码:

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


PG_MODULE_MAGIC;

Datum noddl(PG_FUNCTION_ARGS);

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", trigdata->tag)));

    PG_RETURN_NULL();
}

在你编译了该源代码(见Section 35.9.6)之后,声明该函数和触发器:

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

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

现在你可以测试该触发器的操作:

=# \dy
                     List of event triggers
 Name  |       Event       | Owner | Enabled | Procedure | 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 命令不受事件触发器影响)。 (Recall that DDL commands on event triggers themselves are not affected by event triggers.)