| Документация по PostgreSQL 9.4.1 | |||
|---|---|---|---|
| Пред. | Уровень выше | Глава 42. PL/Perl — процедурный язык Perl | След. |
42.6. Триггеры на PL/Perl
PL/Perl можно использовать для написания триггерных функций. В триггерной функции хеш-массив $_TD содержит информацию о произошедшем событии триггера. $_TD — глобальная переменная, которая получает нужное локальное значение при каждом вызове триггера. Хеш-массив $_TD содержит следующие поля:
- $_TD->{new}{foo}
Новое значение колонки foo
- $_TD->{old}{foo}
Старое значение колонки foo
- $_TD->{name}
Имя вызываемого триггера
- $_TD->{event}
Событие триггера: INSERT, UPDATE, DELETE, TRUNCATE или UNKNOWN
- $_TD->{when}
Когда вызывается триггер: BEFORE (ДО), AFTER (ПОСЛЕ), INSTEAD OF (ВМЕСТО) или UNKNOWN (НЕИЗВЕСТНО)
- $_TD->{level}
Уровень триггера: ROW (СТРОКА), STATEMENT (ОПЕРАТОР) или UNKNOWN (НЕИЗВЕСТНЫЙ)
- $_TD->{relid}
OID таблицы, для которой сработал триггер
- $_TD->{table_name}
Имя таблицы, для которой сработал триггер
- $_TD->{relname}
Имя таблицы, для которой сработал триггер. Это обращение устарело и может быть ликвидировано в будущем выпуске. Используйте вместо него $_TD->{table_name}.
- $_TD->{table_schema}
Имя схемы, содержащей таблицу, для которой сработал триггер
- $_TD->{argc}
Число аргументов в триггерной функции
- @{$_TD->{args}}
Аргументы триггерной функции. Не определено, если $_TD->{argc} равно 0.
В триггерах уровня строки возможны следующие варианты возврата:
- return;
Выполнить операцию
- "SKIP"
Не выполнять операцию
- "MODIFY"
Указывает, что строка NEW была изменена триггерной функцией
Следующий пример триггерной функции иллюстрирует описанные выше варианты:
CREATE TABLE test (
i int,
v varchar
);
CREATE OR REPLACE FUNCTION valid_id() RETURNS trigger AS $$
if (($_TD->{new}{i} >= 100) || ($_TD->{new}{i} <= 0)) {
return "SKIP"; # пропустить команду INSERT/UPDATE
} elsif ($_TD->{new}{v} ne "immortal") {
$_TD->{new}{v} .= "(modified by trigger)";
return "MODIFY"; # изменить строку и выполнить команду INSERT/UPDATE
} else {
return; # выполнить команду INSERT/UPDATE
}
$$ LANGUAGE plperl;
CREATE TRIGGER test_valid_id_trig
BEFORE INSERT OR UPDATE ON test
FOR EACH ROW EXECUTE PROCEDURE valid_id();| Пред. | Начало | След. |
| Доверенный и недоверенный PL/Perl | Уровень выше | Событийные триггеры на PL/Perl |