DROP SUBSCRIPTION

DROP SUBSCRIPTION — elimina una suscripción

Synopsis

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

Descripción

DROP SUBSCRIPTION elimina una suscripción del clúster de la base de datos.

Para ejecutar este comando, el usuario debe ser el propietario de la suscripción.

DROP SUBSCRIPTION no se puede ejecutar dentro de un bloque de transacción si la suscripción está asociada con un slot de replicación. (Puedes usar ALTER SUBSCRIPTION para desvincular el slot).

Parámetros

IF EXISTS

No arroja un error si la suscripción no existe. Se emite una advertencia (notice) en este caso.

nombre

El nombre de la suscripción que se va a eliminar.

CASCADE
RESTRICT

Estas palabras clave no tienen ningún efecto, ya que no hay dependencias sobre las suscripciones.

Notas

Al eliminar una suscripción que está asociada con un slot de replicación en el host remoto (el estado normal), DROP SUBSCRIPTION se conectará al host remoto e intentará eliminar el slot de replicación (y cualquier slot de sincronización de tablas restante) como parte de su operación. Esto es necesario para que se liberen los recursos asignados para la suscripción en el host remoto. Si esto falla, ya sea porque el host remoto no es alcanzable o porque el slot de replicación remoto no se puede eliminar, no existe o nunca existió, el comando DROP SUBSCRIPTION fallará. Para proceder en esta situación, primero deshabilita la suscripción ejecutando ALTER SUBSCRIPTION ... DISABLE, y luego desasóciala del slot de replicación ejecutando ALTER SUBSCRIPTION ... SET (slot_name = NONE). Después de eso, DROP SUBSCRIPTION ya no intentará ninguna acción en el host remoto. Ten en cuenta que si el slot de replicación remoto aún existe, este (y cualquier slot de sincronización de tablas relacionado) debe eliminarse manualmente; de lo contrario, continuará reservando WAL y podría eventualmente hacer que el disco se llene. Consulta también la Section 29.2.1.

Si una suscripción está asociada con un slot de replicación, entonces DROP SUBSCRIPTION no se puede ejecutar dentro de un bloque de transacción.

Ejemplos

Eliminar una suscripción:

DROP SUBSCRIPTION mysub;

Compatibilidad

DROP SUBSCRIPTION es una extensión de PostgreSQL.

Véase también

CREATE SUBSCRIPTION, ALTER SUBSCRIPTION