BEFORE INSERT

📖 Описание

Триггер BEFORE INSERT выполняет код до изменения каждой строки при наличии FOR EACH ROW. Без FOR EACH ROW это триггер уровня оператора: он срабатывает один раз перед оператором INSERT. Момент срабатывания триггера не означает фиксацию транзакции.


🧩 Синтаксис

CREATE OR REPLACE TRIGGER trigger_name
BEFORE INSERT ON table_name
[FOR EACH ROW]
BEGIN
  NULL; -- Здесь размещаются действия триггера
END;
/

⚙️ Параметры и аргументы

trigger_name (имя_триггера) — имя нового триггера; table_name (имя_таблицы) — целевая таблица. Квадратные скобки обозначают необязательную часть синтаксиса. Псевдозаписи :OLD и :NEW доступны в строковом триггере.


📌 Ограничения

  • Показанный триггер создаётся для таблицы. Для обычного представления применяют INSTEAD OF-триггер.
  • Вы можете обновить :NEW (новые) значения.
  • Вы не можете обновить :OLD (старые) значения.

📝 Примечание


💻 Заполнение расчётных и служебных полей

BEFORE INSERT вычисляет стоимость бронирования и заполняет время создания и пользователя подключения. Присваивания :NEW изменяют строку, которая будет записана в таблицу. Отдельный UPDATE той же таблицы не нужен.

CREATE TABLE demo_bi_bookings (
  booking_id NUMBER PRIMARY KEY,
  workshop VARCHAR2(30 CHAR) NOT NULL,
  event_date DATE NOT NULL,
  seats NUMBER(3) NOT NULL CHECK (seats > 0),
  unit_fee NUMBER(7,2) NOT NULL CHECK (unit_fee >= 0),
  total_fee NUMBER(10,2),
  created_at TIMESTAMP WITH TIME ZONE,
  created_by VARCHAR2(128)
);

CREATE OR REPLACE TRIGGER demo_bi_fill
BEFORE INSERT ON demo_bi_bookings
FOR EACH ROW
BEGIN
  :NEW.total_fee := :NEW.seats * :NEW.unit_fee;
  :NEW.created_at := SYSTIMESTAMP;
  :NEW.created_by := SYS_CONTEXT('USERENV', 'SESSION_USER');
END;
/
SELECT trigger_name, status
FROM user_triggers
WHERE trigger_name = 'DEMO_BI_FILL';

SELECT line, position, text
FROM user_errors
WHERE name = 'DEMO_BI_FILL' AND type = 'TRIGGER'
ORDER BY sequence;

После успешного создания статус demo_bi_fill — ENABLED, запрос USER_ERRORS не возвращает строк. ENABLED означает, что триггер включён; отсутствие ошибок компиляции проверяется отдельно. Сначала выполните весь DDL, затем данные и SAVEPOINT: DDL в Oracle делает неявный COMMIT.

💻 Проверка заполнения

SAVEPOINT before_bi_demo;
INSERT INTO demo_bi_bookings
  (booking_id, workshop, event_date, seats, unit_fee)
VALUES (751, 'Mosaic Intro', DATE '2026-11-22', 3, 85);

SELECT booking_id, seats, unit_fee, total_fee,
       CASE WHEN created_at IS NOT NULL AND created_by IS NOT NULL
            THEN 'FILLED' ELSE 'MISSING' END AS metadata_status
FROM demo_bi_bookings WHERE booking_id = 751;

ROLLBACK TO before_bi_demo;
SELECT COUNT(*) AS bookings_after_rollback FROM demo_bi_bookings;
BOOKING_ID SEATS UNIT_FEE TOTAL_FEE METADATA_STATUS
751 3 85 255 FILLED

После отката таблица пуста. Триггер намеренно перезаписывает total_fee, created_at и created_by, даже если вставка передала свои значения. Если нужно заполнять только пропущенные значения, введите соответствующие проверки IS NULL. Для постоянной согласованности total_fee при UPDATE нужен отдельный BEFORE UPDATE либо вычисляемый столбец; один BEFORE INSERT дальнейшие изменения не обслуживает.

Поля :NEW содержат вставляемые значения, :OLD равны NULL. Для обычного триггера изменения принадлежат транзакции вызывающего DML. COMMIT и ROLLBACK выполняются снаружи триггера. Не читайте изменяемую таблицу из её простого строкового триггера: используйте поля псевдозаписей, иначе можно получить ORA-04091.

В примере дата события задана явно в 2026 году. Время аудита и SESSION_USER зависят от фактического запуска; SESSION_USER обозначает пользователя подключения Oracle, а не автоматически пользователя веб-приложения. Для выполнения нужны права на создание учебных таблиц и триггера в своей схеме.

Документация Oracle 19c: dml-triggers, correlation-names-and-pseudorecords, trigger-restrictions.