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.
.gif "Icona di collegamento a un argomento")
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