sp_dropmergepublication (Transact-SQL)

Si applica a: SQL Server

Elimina una pubblicazione di tipo merge e l'agente snapshot associato. Prima di eliminare una pubblicazione di tipo merge, è necessario eliminare tutte le sottoscrizioni. Gli articoli della pubblicazione vengono eliminati automaticamente. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_dropmergepublication
    [ @publication = ] N'publication'
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @reserved = ] reserved ]
    [ , [ @ignore_merge_metadata = ] ignore_merge_metadata ]
[ ; ]

Argomenti

[ @publication = ] N'publication'

Nome della pubblicazione da eliminare. @publication è sysname, senza impostazione predefinita. Se all, tutte le pubblicazioni di tipo merge esistenti vengono rimosse e il processo agente di snapshot associato. Se si specifica un valore specifico per @publication, viene eliminata solo la pubblicazione e il relativo processo di agente di snapshot associato.

[ @ignore_distributor = ] ignore_distributor

Utilizzato per eliminare una pubblicazione senza eseguire attività di pulizia nel server di distribuzione. @ignore_distributor è bit, con il valore predefinito .0 Questo parametro viene utilizzato anche quando si reinstalla il server di distribuzione.

[ @reserved = ] riservato

Riservato a un uso futuro. @reserved è bit, con un valore predefinito .0

[ @ignore_merge_metadata = ] ignore_merge_metadata

Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_dropmergepublication viene usato nella replica di tipo merge.

sp_dropmergepublication elimina in modo ricorsivo tutti gli articoli associati a una pubblicazione e quindi elimina la pubblicazione stessa. Non è possibile rimuovere una pubblicazione se si tratta di una o più sottoscrizioni. Per informazioni su come rimuovere le sottoscrizioni, vedere Eliminare una sottoscrizione push ed eliminare una sottoscrizione pull.

L'esecuzione sp_dropmergepublication di per eliminare una pubblicazione non rimuove gli oggetti pubblicati dal database di pubblicazione o dagli oggetti corrispondenti dal database di sottoscrizione. Utilizzare DROP <object> per rimuovere questi oggetti manualmente, se necessario.

Esempi

DECLARE @publication AS sysname
DECLARE @publicationDB    AS sysname
SET @publication = N'AdvWorksSalesOrdersMerge' 
SET @publicationDB = N'AdventureWorks'

-- Remove the merge publication.
USE [AdventureWorks]
EXEC sp_dropmergepublication @publication = @publication;

-- Remove replication objects from the database.
USE master
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname = N'merge publish', 
  @value = N'false'
GO

Autorizzazioni

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