sp_dropsubscription (Transact-SQL)
Se aplica a: SQL Server Azure SQL Instancia administrada
Quita las suscripciones a un artículo, publicación o conjunto de suscripciones específico del publicador. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicación.
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_dropsubscription
[ [ @publication = ] N'publication' ]
[ , [ @article = ] N'article' ]
, [ @subscriber = ] N'subscriber'
[ , [ @destination_db = ] N'destination_db' ]
[ , [ @ignore_distributor = ] ignore_distributor ]
[ , [ @reserved = ] N'reserved' ]
[ , [ @publisher = ] N'publisher' ]
[ ; ]
Argumentos
[ @publication = ] N'publication'
Nombre de la publicación asociada. @publication es sysname, con un valor predeterminado de NULL
. Si all
es , se cancelan todas las suscripciones de todas las publicaciones del suscriptor especificado. publication es un parámetro obligatorio.
[ @article = ] N'article'
Nombre del artículo. @article es sysname, con un valor predeterminado de NULL
. Si all
es , se quitan las suscripciones a todos los artículos de cada publicación y suscriptor especificados. Se usa all
para publicaciones que permiten la actualización inmediata.
[ @subscriber = ] N'subscriber'
Nombre del suscriptor que tendrá sus suscripciones eliminadas. @subscriber es sysname, sin ningún valor predeterminado. Si all
es , se quitan todas las suscripciones de todos los suscriptores.
[ @destination_db = ] N'destination_db'
El nombre de la base de datos de destino. @destination_db es sysname, con un valor predeterminado de NULL
. Si NULL
es , se quitan todas las suscripciones de ese suscriptor.
[ @ignore_distributor = ] ignore_distributor
Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.
[ @reserved = ] N'reserved'
Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.
[ @publisher = ] N'publisher'
Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.
Valores de código de retorno
0
(correcto) o 1
(erróneo).
Comentarios
sp_dropsubscription
se usa en la replicación transaccional y de instantáneas.
Si quita la suscripción de un artículo en una publicación de sincronización inmediata, no puede agregarla de nuevo a menos que quite las suscripciones de todos los artículos de la publicación y agréguelas de nuevo a la vez.
Ejemplos
-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables
-- on the command line and in SQL Server Management Studio, see the
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".
-- This batch is executed at the Publisher to remove
-- a pull or push subscription to a transactional publication.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @subscriber = $(SubServer);
USE [AdventureWorks2022]
EXEC sp_dropsubscription
@publication = @publication,
@article = N'all',
@subscriber = @subscriber;
GO
Permisos
Solo los miembros del rol fijo de servidor sysadmin , el rol fijo de base de datos db_owner o el usuario que creó la suscripción pueden ejecutar sp_dropsubscription
.