CREATE TRIGGER

Descrição

O comando CREATE TRIGGER cria um gatilho. O gatilho fica associado à tabela especificada e executa a função especificada nome_da_função quando ocorrem determinados eventos. [1] [2] [3]

O gatilho pode ser especificado para disparar antes de tentar realizar a operação na linha (antes das restrições serem verificadas e o comando INSERT, UPDATE ou DELETE ser tentado), ou após a operação estar completa (após as restrições serem verificadas e o comando INSERT, UPDATE ou DELETE ter completado). Se o gatilho for disparado antes do evento, o gatilho pode fazer com que a operação não seja realizada para a linha corrente, ou pode modificar a linha sendo inserida (para as operações de INSERT e UPDATE somente). Se o gatilho for disparado após o evento, todas as mudanças, incluindo a última inserção, atualização ou exclusão, estarão "visíveis" para o gatilho.

Um gatilho que está marcado FOR EACH ROW é chamado uma vez para cada linha que a operação modifica. Por exemplo, um comando DELETE afetando 10 linhas faz com que todos os gatilhos ON DELETE da relação de destino sejam chamados 10 vezes, uma vez para cada linha excluída. Diferentemente, um gatilho que está marcado FOR EACH STATEMENT somente executa uma vez para uma determinada operação, não importando quantas linhas sejam modificadas; em particular, uma operação que não modifica nenhuma linha ainda assim resulta na execução de todos os gatilhos FOR EACH STATEMENT aplicáveis.

Se existirem vários gatilhos do mesmo tipo definidos para o mesmo evento, estes serão disparados na ordem alfabética de seus nomes. [4] [5] [6]

O SELECT não modifica nenhuma linha e, portanto, não é possível criar gatilhos para SELECT. Neste caso as regras e visões são mais apropriadas.

Para obter mais informações sobre gatilhos deve ser consultado o Capítulo 34.

Parâmetros

Observações

Para poder criar um gatilho em uma tabela, o usuário deve possuir o privilégio TRIGGER na tabela.

Nas versões do PostgreSQL anteriores a 7.3 era necessário declarar as funções dos gatilhos como retornando o tipo guardador de lugar opaque, em vez de trigger. Para permitir a carga de cópias de segurança antigas (dump), o comando CREATE TRIGGER aceita funções declaradas como retornando opaque, mas mostra uma mensagem e muda o tipo de dado retornado declarado pela função para trigger.

Para remover um gatilho deve ser utilizado o comando DROP TRIGGER.

Exemplos

A Seção 34.4 contém um exemplo completo.

Compatibilidade

O comando CREATE TRIGGER do PostgreSQL implementa um subconjunto do padrão SQL. As seguintes funcionalidades estão faltando:

• O padrão SQL permite aos gatilhos disparar devido a atualização de colunas específicas (por exemplo, AFTER UPDATE OF col1, col2).

• O padrão SQL permite definir outros nomes (aliases) para as linhas e tabelas "OLD" e "NEW" a serem utilizados na definição da ação do gatilho (por exemplo, CREATE TRIGGER ... ON nome_da_tabela REFERENCING OLD ROW AS algum_nome NEW ROW AS outro_nome ...). Uma vez que o PostgreSQL permite que os procedimentos dos gatilhos sejam escritos em qualquer uma das linguagens definidas pelo usuário, o acesso aos dados é tratado na forma específica da linguagem.

• O PostgreSQL somente permite para a ação do gatilho a execução de uma função definida pelo usuário. O padrão SQL permite para a ação do gatilho a execução de vários outros comandos SQL, como CREATE TABLE. Esta limitação é fácil de ser superada: basta criar uma função definida pelo usuário para executar os comandos desejados.

O padrão SQL especifica que gatilhos múltiplos devem ser disparados na ordem da data de criação. O PostgreSQL usa a ordem dos nomes, que foi julgada ser mais conveniente.

O padrão SQL especifica que nas exclusões em cascata os gatilhos BEFORE DELETE são disparados após o DELETE em cascata estar completo. O comportamento do PostgreSQL é para disparar sempre os gatilhos BEFORE DELETE antes da ação de exclusão, mesmo que seja uma exclusão em cascata. Este comportamento é considerado mais consistente. Também existe um comportamento não previsível quando gatilhos BEFORE modificam linhas que serão posteriormente modificadas por ações referenciais. Isto pode levar a violações de restrição ou a dados armazenados que não respeitam a restrição referencial.

A capacidade de especificar várias ações para um único gatilho utilizando OR é uma extensão do PostgreSQL ao padrão SQL.

Consulte também