DROP SUBSCRIPTION — remove uma subscrição
DROP SUBSCRIPTION [ IF EXISTS ] nome
[ CASCADE | RESTRICT ]
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.)
nomeO nome da subscrição a ser removida.
CASCADERESTRICTEstas palavras-chave não têm efeito, porque não há dependências de subscrições.
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.
Remover uma subscrição:
DROP SUBSCRIPTION minha_subscrição;
O DROP SUBSCRIPTION é uma extensão do
PostgreSQL.