↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3
历史版本。 PostgreSQL 11 已结束支持。 2023-11-09. 请参阅 当前版本手册.

CREATE EVENT TRIGGER

CREATE EVENT TRIGGER — 定义一个新的事件触发器

大纲

CREATE EVENT TRIGGER name
    ON event
    [ WHEN filter_variable IN (filter_value [, ... ]) [ AND ... ] ]
    EXECUTE { FUNCTION | PROCEDURE } function_name()

描述

CREATE EVENT TRIGGER 创建一个新的事件触发器。每当指定的事件发生,并且与该触发器关联的 WHEN 条件(如果有)得到满足时,就会执行该触发器函数。有关事件触发器的一般性介绍,见第 40 章。创建事件触发器的用户将成为其所有者。

参数

name

要赋予新触发器的名称。该名称在数据库内必须唯一。

event

触发对给定函数调用的事件名称。有关事件名称的更多信息,见第 40.1 节。

filter_variable

用于过滤事件的变量名称。这样可以将触发器限定为只在原本支持的部分情形下触发。当前唯一支持的 filter_variable 是 TAG。

filter_value

与相关 filter_variable 关联的一组值;当其取值属于该列表时,触发器就会被触发。对于 TAG,这表示一组命令标签(例如 'DROP FUNCTION')。

function_name

由用户提供的函数,声明为不接受参数并返回类型 event_trigger。

在 CREATE EVENT TRIGGER 的语法中,关键字 FUNCTION 和 PROCEDURE 是等效的,但被引用的对象无论如何都必须是函数,而不是过程。这里使用关键字 PROCEDURE 属于历史遗留做法,现已弃用。

注解

只有超级用户能创建事件触发器。

事件触发器在单用户模式下被禁用(参见 postgres)。如果错误的事件触发器导致数据库严重失效,以至于无法删除触发器,可以重启到单用户模式,然后就能执行删除操作。

示例

禁止执行任何 DDL 命令:

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 FUNCTION abort_any_command();

兼容性

在 SQL 标准中没有 CREATE EVENT TRIGGER 语句。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.