sp_dropmergesubscription (Transact-SQL)

Elimina una sottoscrizione di una pubblicazione di tipo merge e l'agente di merge corrispondente. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @publication= ] 'publication'
    Nome della pubblicazione. publication è di tipo sysname e il valore predefinito è NULL. La pubblicazione deve essere già esistente e conforme alle regole per gli identificatori.

  • [ @subscriber=] 'subscriber'
    Nome del Sottoscrittore. subscriber è di tipo sysname e il valore predefinito è NULL.

  • [ @subscriber_db= ] 'subscriber_db'
    Nome del database di sottoscrizione. subscription_database è di tipo sysname e il valore predefinito è NULL.

  • [ @subscription_type= ] 'subscription_type'
    Tipo di sottoscrizione. subscription_typeè di tipo nvarchar(15) e i possibili valori sono i seguenti.

    Valore

    Descrizione

    all

    Sottoscrizioni push, pull e anonime.

    anonymous

    Sottoscrizione anonima.

    push

    Sottoscrizione push.

    pull

    Sottoscrizione pull.

    both(valore predefinito)

    Sottoscrizione sia push che pull.

  • [ @ignore_distributor = ] ignore_distributor
    Indica se questa stored procedure viene eseguita senza stabilire la connessione al server di distribuzione. ignore_distributor è di tipo bit e il valore predefinito è 0. È possibile utilizzare questo parametro per eliminare una sottoscrizione senza eseguire attività di rimozione dei dati nel server di distribuzione. Risulta inoltre utile se è stato necessario reinstallare il server di distribuzione.

  • [ @reserved= ] reserved
    Riservato per utilizzi futuri. reserved è di tipo bit e il valore predefinito è 0.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_dropmergesubscription viene utilizzata in repliche di tipo merge.

Esempio

-- 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

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin o del ruolo predefinito del database db_owner possono eseguire sp_dropmergesubscription.