CREATE EVENT TRIGGER
CREATE EVENT TRIGGER — создать событийный триггер
Синтаксис
CREATE EVENT TRIGGERимяONсобытие[ WHENпеременная_фильтраIN (значение_фильтра[, ... ]) [ AND ... ] ] EXECUTE { FUNCTION | PROCEDURE }имя_функции()
Описание
CREATE EVENT TRIGGER создаёт новый событийный триггер. Функция триггера выполняется, когда происходит указанное событие и удовлетворяется связанное с триггером условие WHEN (если такое имеется). За вводной информацией по триггерам обратитесь к Главе 38. Владельцем триггера становится пользователь его создавший.
Параметры
имяИмя, назначаемое новому триггеру. Это имя должно быть уникальным в базе данных.
событиеИмя события, при котором срабатывает триггер и вызывается заданная функция. Подробнее об именах событий можно узнать в Разделе 38.1.
переменная_фильтраИмя переменной, применяемой для фильтрования событий. Это указание позволяет ограничить срабатывание триггера подмножеством случаев, в которых он поддерживается. В настоящее время единственно возможное значение параметра
переменная_фильтра—TAG.значение_фильтраСписок значений связанного параметра
переменная_фильтра, для которых должен срабатывать триггер. Для переменнойTAGэто список меток команд (например,'DROP FUNCTION').имя_функцииЗаданная пользователем функция, объявленная как функция без аргументов и возвращающая тип
event_trigger.В синтаксисе
CREATE EVENT TRIGGERключевые словаFUNCTIONиPROCEDUREравнозначны, но указываемая функция должна в любом случае быть функцией, а не процедурой. Ключевое словоPROCEDUREздесь поддерживается по историческим причинам и считается устаревшим.
Примечания
Создавать событийные триггеры могут только суперпользователи.
Событийные триггеры не вызываются в однопользовательском режиме (см. postgres) и при значении false у параметра event_triggers. Если ошибочный событийный триггер заблокировал работу с базой данных так, что даже удалить его нельзя, перезапустите сервер, задав значение false для параметра event_triggers, или в однопользовательском режиме, и его можно будет удалить.
Примеры
Триггер, запрещающий выполнение любой команды 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();
Совместимость
Оператор CREATE EVENT TRIGGER отсутствует в стандарте SQL.