CREATE EVENT TRIGGER
CREATE EVENT TRIGGER — создать событийный триггер
Синтаксис
CREATE EVENT TRIGGERимяONсобытие[ WHENпеременная_фильтраIN (значение_фильтра[, ... ]) [ AND ... ] ] EXECUTE PROCEDUREимя_функции()
Описание
CREATE EVENT TRIGGER создаёт новый событийный триггер. Функция триггера выполняется, когда происходит указанное событие и удовлетворяется связанное с триггером условие WHEN (если такое имеется). За вводной информацией по триггерам обратитесь к Главе 39. Владельцем триггера становится пользователь его создавший.
Параметры
имяИмя, назначаемое новому триггеру. Это имя должно быть уникальным в базе данных.
событиеИмя события, при котором срабатывает триггер и вызывается заданная функция. Подробнее об именах событий можно узнать в Разделе 39.1.
переменная_фильтраИмя переменной, применяемой для фильтрования событий. Это указание позволяет ограничить срабатывание триггера подмножеством случаев, в которых он поддерживается. В настоящее время единственно возможное значение параметра
переменная_фильтра—TAG.значение_фильтраСписок значений связанного параметра
переменная_фильтра, для которых должен срабатывать триггер. Для переменнойTAGэто список меток команд (например,'DROP FUNCTION').имя_функцииЗаданная пользователем функция, объявленная как функция без аргументов и возвращающая тип
event_trigger.
Замечания
Создавать событийные триггеры могут только суперпользователи.
Событийные триггеры не вызываются в однопользовательском режиме (см. postgres). Если ошибочный событийный триггер заблокировал работу с базой данных так, что даже удалить его нельзя, перезапустите сервер в однопользовательском режиме и это можно будет сделать.
Примеры
Триггер, запрещающий выполнение любой команды DDL:
CREATE OR REPLACE FUNCTION abort_any_command() RETURNS event_trigger LANGUAGE plpgsql AS $$ BEGIN RAISE EXCEPTION 'команда % отключена', tg_tag; END; $$; CREATE EVENT TRIGGER abort_ddl ON ddl_command_start EXECUTE PROCEDURE abort_any_command();
Совместимость
Оператор CREATE EVENT TRIGGER отсутствует в стандарте SQL.
См. также
ALTER EVENT TRIGGER, DROP EVENT TRIGGER, CREATE FUNCTIONCREATE EVENT TRIGGER
CREATE EVENT TRIGGER — define a new event trigger
Synopsis
CREATE EVENT TRIGGERnameONevent[ WHENfilter_variableIN (filter_value[, ... ]) [ AND ... ] ] EXECUTE PROCEDUREfunction_name()
Description
CREATE EVENT TRIGGER creates a new event trigger. Whenever the designated event occurs and the WHEN condition associated with the trigger, if any, is satisfied, the trigger function will be executed. For a general introduction to event triggers, see Chapter 39. The user who creates an event trigger becomes its owner.
Parameters
nameThe name to give the new trigger. This name must be unique within the database.
eventThe name of the event that triggers a call to the given function. See Section 39.1 for more information on event names.
filter_variableThe name of a variable used to filter events. This makes it possible to restrict the firing of the trigger to a subset of the cases in which it is supported. Currently the only supported
filter_variableisTAG.filter_valueA list of values for the associated
filter_variablefor which the trigger should fire. ForTAG, this means a list of command tags (e.g.,'DROP FUNCTION').function_nameA user-supplied function that is declared as taking no argument and returning type
event_trigger.
Notes
Only superusers can create event triggers.
Event triggers are disabled in single-user mode (see postgres). If an erroneous event trigger disables the database so much that you can't even drop the trigger, restart in single-user mode and you'll be able to do that.
Examples
Forbid the execution of any DDL command:
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 PROCEDURE abort_any_command();
Compatibility
There is no CREATE EVENT TRIGGER statement in the SQL standard.
