sp_dropsubscription (Transact-SQL)
Elimina le sottoscrizioni di un determinato articolo, pubblicazione o insieme di sottoscrizioni nel server di pubblicazione. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.
.gif "Icona di collegamento a un argomento")
Convenzioni della sintassi Transact-SQL
Sintassi
sp_dropsubscription [ [ @publication= ] 'publication' ]
[ , [ @article= ] 'article' ]
, [ @subscriber= ] 'subscriber'
[ , [ @destination_db= ] 'destination_db' ]
[ , [ @ignore_distributor = ] ignore_distributor ]
[ , [ @reserved= ] 'reserved' ]
Argomenti
- [ @publication= ] 'publication'
Nome della pubblicazione associata. publication è di tipo sysname e il valore predefinito è NULL. Se è uguale a all, vengono annullate tutte le sottoscrizioni di tutte le pubblicazioni del Sottoscrittore specificato. publication è un parametro obbligatorio.
- [ @article= ] 'article'
Nome dell'articolo. article è di tipo sysname e il valore predefinito è NULL. Se è uguale a all, vengono eliminate le sottoscrizioni di tutti gli articoli di ogni pubblicazione e Sottoscrittore specificati. Utilizzare all per pubblicazioni che consentono l'aggiornamento immediato. article è un parametro obbligatorio.
- [ @subscriber= ] 'subscriber'
Nome del Sottoscrittore da cui si desidera eliminare le sottoscrizioni. subscriber è di tipo sysname e non prevede alcun valore predefinito. Se è uguale a all, vengono eliminate tutte le sottoscrizioni di tutti i Sottoscrittori.
- [ @destination_db= ] 'destination_db'
Nome del database di destinazione. destination_db è di tipo sysname e il valore predefinito è NULL, con cui vengono eliminate tutte le sottoscrizioni dal Sottoscrittore specificato.
- [ @ignore_distributor = ] ignore_distributor
Solo per uso interno.
- [ @reserved= ] 'reserved'
Solo per uso interno.
Osservazioni
La stored procedure sp_dropsubscription viene utilizzata per la replica snapshot e transazionale.
Se si elimina la sottoscrizione di un articolo in una pubblicazione a sincronizzazione immediata, non è possibile aggiungerla nuovamente, a meno che le sottoscrizioni di tutti gli articoli della pubblicazione non vengano eliminate e aggiunte nuovamente in una sola operazione.
Autorizzazioni
Solo i membri del ruolo predefinito del server sysadmin, del ruolo predefinito del database db_owner e l'utente che ha creato la sottoscrizione possono eseguire sp_dropsubscription.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
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 transactional publication.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @subscriber = $(SubServer);
USE [AdventureWorks]
EXEC sp_dropsubscription
@publication = @publication,
@article = N'all',
@subscriber = @subscriber;
GO
Vedere anche
Riferimento
sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL)
sp_helpsubscription (Transact-SQL)
Altre risorse
How to: Delete a Push Subscription (Replication Transact-SQL Programming)