ALTER TRIGGER

ALTER TRIGGER — modifica a definição de um gatilho

Sinopse

ALTER TRIGGER nome ON nome_da_tabela​
    RENAME TO novo_nome
ALTER TRIGGER nome ON nome_da_tabela​
    [ NO ] DEPENDS ON EXTENSION nome_da_extensão

Descrição

O comando ALTER TRIGGER altera as propriedades de um gatilho existente.

A cláusula RENAME altera o nome do gatilho especificado, sem alterar a definição do gatilho. Se a tabela na qual o gatilho está presente for uma tabela particionada, os gatilhos clone correspondentes nas partições também serão renomeados.

A cláusula DEPENDS ON EXTENSION marca o gatilho como dependente de uma extensão, de modo que, se a extensão for removida, o gatilho também será removido junto.

É necessário ser o dono da tabela na qual o gatilho atua para poder alterar suas propriedades.

Parâmetros

nome

O nome do gatilho existente a ser alterado.

nome_da_tabela

O nome da tabela na qual o gatilho atua.

novo_nome

O novo nome para o gatilho.

nome_da_extensão

O nome da extensão da qual o gatilho vai se tornar dependente (ou não vai mais ser dependente, se for especificado NO). Um gatilho marcado como dependente de uma extensão é removido automaticamente quando a extensão é removida.

Notas

A capacidade de ativar ou desativar temporariamente um gatilho é fornecida pelo comando ALTER TABLE, e não pelo comando ALTER TRIGGER, porque o comando ALTER TRIGGER não tem uma maneira conveniente de expressar a opção de ativar ou desativar todos os gatilhos de uma tabela de uma só vez.

Exemplos

Para mudar o nome de um gatilho existente:

ALTER TRIGGER emp_stamp ON emp RENAME TO emp_track_chgs;

Para marcar um gatilho como dependente de uma extensão:

ALTER TRIGGER emp_stamp ON emp DEPENDS ON EXTENSION emplib;

Conformidade

O comando ALTER TRIGGER é uma extensão do PostgreSQL ao padrão SQL.

Veja também

CREATE TRIGGER, ALTER TABLE