DROP SUBSCRIPTION

DROP SUBSCRIPTION — remove uma subscrição

Sinopse

DROP SUBSCRIPTION [ IF EXISTS ] nome
                  [ CASCADE | RESTRICT ]

Descrição

O comando DROP SUBSCRIPTION remove uma subscrição do agrupamento de bancos de dados (instância).

Para executar este comando, o usuário deve ser o dono da subscrição.

O comando DROP SUBSCRIPTION não poderá ser executado dentro de um bloco de transação, se a subscrição estiver associada a um encaixe de replicação. Pode ser usado o comando ALTER SUBSCRIPTION para liberar o encaixe.)

Parâmetros

nome

O nome da subscrição a ser removida.

CASCADE
RESTRICT

Estas palavras-chave não têm efeito, porque não há dependências de subscrições.

Notas

Ao remover uma subscrição associada a um encaixe de replicação no hospedeiro remoto (o estado normal), o comando DROP SUBSCRIPTION irá se conectar ao hospedeiro remoto e tentar remover o encaixe de replicação (e quaisquer encaixes de sincronização de tabela restantes) como parte de sua operação. Isto é necessário para que os recursos alocados para a subscrição no hospedeiro remoto sejam liberados. Se isto falhar, porque o hospedeiro remoto não está acessível, ou porque o encaixe de replicação remota não pode ser removido, ou não existe ou nunca existiu, o comando DROP SUBSCRIPTION irá falhar. Para prosseguir nesta situação, primeiro deve ser desativada a subscrição executando o comando: ALTER SUBSCRIPTION ... DISABLE e, em seguida, desassociar do encaixe de replicação executando o comando: ALTER SUBSCRIPTION ... SET (slot_name = NONE). Depois disso, o comando DROP SUBSCRIPTION não tentará mais nenhuma ação no hospedeiro remoto. Note que, se o encaixe de replicação remota ainda existir, ele (e quaisquer encaixes de sincronização de tabela relacionados) deverá ser removido manualmente; caso contrário, o servidor continuará armazenando WAL podendo, por fim, fazer com que o disco fique cheio. Veja também Seção 29.2.1.

Se a subscrição estiver associada a um encaixe de replicação, então o comando DROP SUBSCRIPTION não poderá ser executado em um bloco de transação.

Exemplos

Remover uma subscrição:

DROP SUBSCRIPTION minha_subscrição;

Conformidade

O DROP SUBSCRIPTION é uma extensão do PostgreSQL.

Veja também

CREATE SUBSCRIPTION, ALTER SUBSCRIPTION