sp_dropmergearticle (Transact-SQL)

Rimuove un articolo da una pubblicazione di tipo merge. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_dropmergearticle [ @publication= ] 'publication'
        , [ @article= ] 'article' 
    [ , [ @ignore_distributor= ] ignore_distributor 
    [ , [ @reserved= ] reserved 
    [ , [ @force_invalidate_snapshot= ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @ignore_merge_metadata = ] ignore_merge_metadata ]

Argomenti

• [ @publication=] 'publication'
  Nome della pubblicazione dalla quale eliminare un articolo. publication è di tipo sysname e non prevede alcun valore predefinito.

• [ @article=] 'article'
  Nome dell'articolo da eliminare dalla pubblicazione specificata. article è di tipo sysname e non prevede alcun valore predefinito. Se si specifica all, tutti gli articoli esistenti nella pubblicazione di tipo merge specificata vengono rimossi. Anche se per article viene specificato all, la pubblicazione deve essere comunque eliminata tramite un'operazione distinta dalla rimozione dell'articolo.

• [ @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.

• [ @reserved=] reserved
  Riservato per utilizzi futuri. reserved è di tipo nvarchar(20) e il valore predefinito è NULL.

• [ @force_invalidate_snapshot=] force_invalidate_snapshot
  Abilita o disabilita la possibilità di invalidare uno snapshot. force_invalidate_snapshot è di tipo bit e il valore predefinito è 0.

  0 specifica che le modifiche apportate all'articolo di merge non invalidano lo snapshot.

  1 specifica che le modifiche apportate all'articolo di merge potrebbero invalidare lo snapshot. Se lo snapshot viene invalidato, il valore 1 consente di eseguire un nuovo snapshot.

• [ @force_reinit_subscription = ] force_reinit_subscription
  Riconosce che l'eliminazione dell'articolo potrebbe richiedere la reinizializzazione delle sottoscrizioni esistenti. force_reinit_subscription è di tipo bit e il valore predefinito è 0.

  0 specifica che l'eliminazione dell'articolo non comporta la reinizializzazione della sottoscrizione.

  1 specifica che l'eliminazione dell'articolo comporta la reinizializzazione delle sottoscrizioni esistenti e consente la reinizializzazione.

• [ @ignore_merge_metadata= ] ignore_merge_metadata
  Solo per uso interno.

Osservazioni

La stored procedure sp_dropmergearticle viene utilizzata per la replica di tipo merge. Per ulteriori informazioni sull'eliminazione di articoli, vedere Aggiunta ed eliminazione di articoli a e da pubblicazioni esistenti.

L'esecuzione della stored procedure sp_dropmergearticle per eliminare un articolo da una pubblicazione non comporta la rimozione dell'oggetto dal database di pubblicazione o dell'oggetto corrispondente dal database di sottoscrizione. Utilizzare DROP <object> per rimuovere questi oggetti manualmente, se necessario.

Autorizzazioni

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

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Esempio

DECLARE @publication AS sysname;
DECLARE @article1 AS sysname;
DECLARE @article2 AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @article1 = N'SalesOrderDetail'; 
SET @article2 = N'SalesOrderHeader'; 

-- Remove articles from a merge publication.
USE [AdventureWorks]
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @article1,
  @force_invalidate_snapshot = 1;
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @article2,
  @force_invalidate_snapshot = 1;
GO

Vedere anche

Riferimento

sp_addmergearticle (Transact-SQL)
sp_changemergearticle (Transact-SQL)
sp_helpmergearticle (Transact-SQL)
Stored procedure per la replica (Transact-SQL)

Altre risorse

How to: Delete an Article (Replication Transact-SQL Programming)
Aggiunta ed eliminazione di articoli a e da pubblicazioni esistenti

Guida in linea e informazioni

Assistenza su SQL Server 2005