PolarDB:Crie um trigger

Pré-requisitos

Antes de começar, verifique se você tem o privilégio CREATE TRIGGER na tabela de destino.

Sintaxe

CREATE [ OR REPLACE ] TRIGGER name
  { BEFORE | AFTER | INSTEAD OF }
  {INSERT | UPDATE | DELETE}
      [ OR { INSERT | UPDATE | DELETE } ] [, ...]
    ON table
  [ REFERENCING { OLD AS old | NEW AS new } ...]
  [ FOR EACH ROW ]
  [ WHEN condition ]
  [ DECLARE
      [ PRAGMA AUTONOMOUS_TRANSACTION; ]
      declaration; [, ...] ]
    BEGIN
      statement; [, ...]
  [ EXCEPTION
    { WHEN exception [ OR exception ] [...] THEN
        statement; [, ...] } [, ...]
  ]
    END

Descrição

O comando CREATE TRIGGER define um novo trigger. O comando CREATE OR REPLACE TRIGGER cria um trigger ou substitui uma definição existente.

Ao criar um novo trigger, o nome não pode coincidir com nenhum trigger existente na mesma tabela. O sistema cria o novo trigger no mesmo schema da tabela onde o evento de disparo está definido. Para atualizar a definição de um trigger existente, use CREATE OR REPLACE TRIGGER.

Tempo e comportamento do trigger

O momento de execução determina quando o trigger dispara em relação à verificação de restrições e quais ações o corpo do trigger pode executar:

• BEFORE: O trigger dispara antes da verificação das restrições e antes da tentativa da operação DML. O corpo do trigger pode modificar a linha inserida ou atualizada, ou cancelar toda a operação.

• AFTER: O disparo ocorre após a verificação das restrições e a conclusão da operação DML. Todas as alterações, inclusive as feitas por outros triggers, ficam visíveis para o corpo do trigger.

• INSTEAD OF: Válido apenas em views. O trigger dispara no lugar da operação DML. Use INSTEAD OF para permitir que views não atualizáveis aceitem operações de INSERT, UPDATE e DELETE.

Triggers no nível de linha versus no nível de instrução

• Nível de linha (FOR EACH ROW): dispara uma vez para cada linha afetada. Um comando DELETE que remove 10 linhas aciona o trigger 10 vezes.

• Nível de instrução (sem FOR EACH ROW): dispara uma única vez por instrução SQL, independentemente da quantidade de linhas afetadas, inclusive zero.

Segurança

Ao criar um trigger com sintaxe compatível com Oracle, ele executa como uma função SECURITY DEFINER. Isso significa que a execução usa os privilégios do proprietário do trigger, e não do usuário que causou o disparo.

A cláusula REFERENCING não é totalmente compatível com o Oracle Database. Os identificadores após OLD AS e NEW AS devem ser old e new ou qualquer equivalente salvo inteiramente em letras minúsculas (por exemplo, REFERENCING OLD AS old , REFERENCING OLD AS OLD ou REFERENCING OLD AS "old" ). Identificadores diferentes de old ou new não têm suporte.

Parâmetros

Exemplos

CREATE OR REPLACE TRIGGER set_created_at
  BEFORE INSERT ON orders
  FOR EACH ROW
DECLARE
BEGIN
  :NEW.created_at := SYSDATE;
END;

CREATE OR REPLACE TRIGGER log_salary_change
  AFTER UPDATE ON employees
  FOR EACH ROW
  WHEN (OLD.salary != NEW.salary)
DECLARE
BEGIN
  INSERT INTO salary_audit (emp_id, old_salary, new_salary, changed_at)
  VALUES (:OLD.emp_id, :OLD.salary, :NEW.salary, SYSDATE);
END;

CREATE OR REPLACE TRIGGER audit_order_delete
  AFTER DELETE ON orders
DECLARE
BEGIN
  INSERT INTO audit_log (action, action_time)
  VALUES ('DELETE from orders', SYSDATE);
END;

CREATE OR REPLACE TRIGGER insert_active_employee
  INSTEAD OF INSERT ON active_employees
  FOR EACH ROW
DECLARE
BEGIN
  INSERT INTO employees (emp_id, name, status)
  VALUES (:NEW.emp_id, :NEW.name, 'ACTIVE');
END;