下面是一个用 C 编写的非常简单的事件触发器函数示例。 (使用过程语言编写的触发器示例可在各过程语言的文档中找到。)
函数 noddl 每次被调用时都会抛出异常。 事件触发器定义将该函数与 ddl_command_start 事件关联起来。 其效果是阻止所有 DDL 命令运行(不包括 Section 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();
}
编译源代码之后(见 Section 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 命令不会受事件触发器影响。)
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。