sp_dropmergesubscription (Transact-SQL)

Descarta uma assinatura de uma publicação de mesclagem e seu Merge Agent associado. Esse procedimento armazenado é executado no Publicador, no banco de dados de publicação.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • [ @publication= ] 'publication'
    É o nome da publicação. publication é sysname, com um padrão NULL. A publicação já deve existir e ser adequada às regras para identificadores.

  • [ @subscriber=] 'subscriber'
    É o nome do Assinante. subscriber é sysname, com um padrão NULL.

  • [ @subscriber_db= ] 'subscriber_db'
    É o nome do banco de dados de assinatura. subscription_database é sysname, com um padrão NULL.

  • [ @subscription_type= ] 'subscription_type'
    É o tipo de assinatura. subscription_type é nvarchar(15), e pode ser um destes valores.

    Valor

    Descrição

    all

    Assinaturas push, pull e anônimas

    anonymous

    Assinatura anônimas.

    push

    Assinatura push.

    pull

    Assinatura pull.

    both (padrão)

    Assinaturas push e pull.

  • [ @ignore_distributor = ] ignore_distributor
    Indica se esse procedimento armazenado será executado sem se conectar ao Distribuidor. ignore_distributor é bit, com um padrão 0. Esse parâmetro pode ser usado para descartar uma assinatura sem tarefas de limpeza no Distribuidor. Também é útil, se for necessário reinstalar o Distribuidor.

  • [ @reserved= ] reserved
    Reservado para uso futuro. reserved é bit, com um padrão 0.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_dropmergesubscription é usado em replicação de mesclagem.

Exemplo

-- 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'AdventureWorksReplica';

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

Permissões

Somente membros da função de servidor fixa sysadmin ou db_owner podem executar sp_dropmergesubscription.