SQL COMMAND · 触发器与规则
CREATE EVENT TRIGGER
定义一个新的事件触发器
define a new event trigger
CREATE触发器与规则引入 9.3现存至 20 devel1 次语法变更
- 动词
CREATE- 对象
EVENT TRIGGER- 分组
- 触发器与规则
- 引入版本
- 9.3
- 状态
- 现存
- 语法变更次数
- 1
- 手册小节数
- 6
版本轨迹
相对 PostgreSQL 17 无变化。
语法铁道图 PostgreSQL 18
沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。
语法概要
CREATE EVENT TRIGGER name ON event [ WHEN filter_variable IN (filter_value [, ... ]) [ AND ... ] ] EXECUTE { FUNCTION | PROCEDURE } function_name()
描述
CREATE EVENT TRIGGER 创建一个新的事件触发器。每当指定的事件发生,并且与该触发器关联的 WHEN 条件(如果有)得到满足时,就会执行该触发器函数。有关事件触发器的一般性介绍,见第 38 章。创建事件触发器的用户将成为其所有者。
参数
name要赋予新触发器的名称。该名称在数据库内必须唯一。
event触发对给定函数调用的事件名称。有关事件名称的更多信息,见第 38.1 节。
filter_variable用于过滤事件的变量名称。这样可以将触发器限定为只在原本支持的部分情形下触发。当前唯一支持的
filter_variable是TAG。filter_value与相关
filter_variable关联的一组值;当其取值属于该列表时,触发器就会被触发。对于TAG,这表示一组命令标签(例如'DROP FUNCTION')。function_name由用户提供的函数,声明为不接受参数并返回类型
event_trigger。在
CREATE EVENT TRIGGER的语法中,关键字FUNCTION和PROCEDURE是等效的,但被引用的对象无论如何都必须是函数,而不是过程。这里使用关键字PROCEDURE属于历史遗留做法,现已弃用。
注解
只有超级用户能创建事件触发器。
在单用户模式(见 postgres)下,以及当 event_triggers 被设置为 false 时,事件触发器都会被禁用。如果某个错误的事件触发器使数据库严重不可用,甚至无法删除该触发器,可以在将 event_triggers 设置为 false 的情况下重启,以临时禁用事件触发器,或者以单用户模式重启,这样就可以删除它。
示例
禁止执行任何 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 语句。
另见
语法演化
相邻大版本之间的差异,新的在前。版本号链接到对应快照。
PostgreSQL 17← 16正文更新
正文更新PostgreSQL 14← 13正文更新
正文更新PostgreSQL 12← 11正文更新
正文更新PostgreSQL 11← 10语法变化
+ EXECUTE { FUNCTION | PROCEDURE } function_name()正文更新PostgreSQL 10← 9.6正文更新
正文更新PostgreSQL 9.6← 9.5正文更新
正文更新PostgreSQL 9.5← 9.4正文更新
正文更新PostgreSQL 9.3← 9.2新增此命令
同组命令
| 命令 | 动词 | 对象 | 版本变动 | 最近变更 |
|---|---|---|---|---|
CREATE CONSTRAINT TRIGGER | CREATE | CONSTRAINT TRIGGER | 9.03 次 | |
| 定义一个新的约束触发器 | 于 9.1 移除 | |||
CREATE EVENT TRIGGER | CREATE | EVENT TRIGGER | 111 次 | |
| 定义一个新的事件触发器 | 现存 | |||
ALTER EVENT TRIGGER | ALTER | EVENT TRIGGER | 142 次 | |
| 更改事件触发器的定义 | 现存 | |||
DROP EVENT TRIGGER | DROP | EVENT TRIGGER | — | |
| 移除一个事件触发器 | 现存 | |||
CREATE RULE | CREATE | RULE | 9.46 次 | |
| 定义一条新的重写规则 | 现存 | |||
ALTER RULE | ALTER | RULE | — | |
| 修改一条重写规则的定义 | 现存 | |||
DROP RULE | DROP | RULE | 9.25 次 | |
| 移除一条重写规则 | 现存 | |||
CREATE TRIGGER | CREATE | TRIGGER | 1911 次 | |
| 定义一个新触发器 | 现存 | |||
ALTER TRIGGER | ALTER | TRIGGER | 135 次 | |
| 更改触发器的定义 | 现存 | |||
DROP TRIGGER | DROP | TRIGGER | 9.23 次 | |
| 移除一个触发器 | 现存 | |||