sp_dropmergesubscription (Transact-SQL)

Se aplica a:SQL Server

Quita una suscripción a una publicación de combinación y su Agente de mezcla asociado. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicación.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_dropmergesubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @subscriber_db = ] N'subscriber_db' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @reserved = ] reserved ]
[ ; ]

Argumentos

[ @publication = ] N'publication'

El nombre de la publicación. @publication es sysname, con un valor predeterminado de NULL. La publicación ya debe existir y cumplir las reglas de los identificadores.

[ @subscriber = ] N'subscriber'

Nombre del suscriptor. @subscriber es sysname, con un valor predeterminado de NULL.

[ @subscriber_db = ] N'subscriber_db'

Nombre de la base de datos de suscripciones. @subscriber_db es sysname, con un valor predeterminado de NULL.

[ @subscription_type = ] N'subscription_type'

Tipo de suscripción. @subscription_type es nvarchar(15) y puede ser uno de estos valores.

Valor Descripción
all Suscripciones de inserción, de extracción y anónimas.
anonymous Suscripción anónima.
push Suscripción de inserción.
pull Suscripción de extracción.
both (valor predeterminado) Suscripción de inserción y de extracción.

[ @ignore_distributor = ] ignore_distributor

Indica si este procedimiento almacenado se ejecuta sin conectarse al distribuidor. @ignore_distributor es bit, con un valor predeterminado de 0. Este parámetro se puede utilizar para quitar una suscripción sin tener que realizar tareas de limpieza en el distribuidor. También es útil si tiene que volver a instalar el distribuidor.

[ @reserved = ] reserved

Reservado para uso futuro. @reserved es bit, con un valor predeterminado de 0.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_dropmergesubscription se usa en la replicación de mezcla.

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 merge publication.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorks2022Replica';

USE [AdventureWorks2022]
EXEC sp_dropmergesubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB;
GO

Permisos

Solo los miembros del rol fijo de servidor sysadmin o el rol fijo de base de datos db_owner pueden ejecutar sp_dropmergesubscription.