sp_droparticle (Transact-SQL)

Si applica a: sìSQL Server (tutte le versioni supportate) SìIstanza gestita di SQL di Azure

Elimina un articolo da una pubblicazione snapshot o transazionale. Non è possibile rimuovere un articolo se esistono una o più sottoscrizioni per tale articolo. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

  
sp_droparticle [ @publication= ] 'publication'  
        , [ @article= ] 'article'  
    [ , [ @ignore_distributor = ] ignore_distributor ]  
    [ , [ @force_invalidate_snapshot= ] force_invalidate_snapshot ]  
    [ , [ @publisher = ] 'publisher' ]  
    [ , [ @from_drop_publication = ] from_drop_publication ]  

Argomenti

[ @publication = ] 'publication' Nome della pubblicazione che contiene l'articolo da eliminare. publication è sysname, senza alcun valore predefinito.

[ @article = ] 'article' Nome dell'articolo da eliminare. article è sysname, senza alcun valore predefinito.

[ @ignore_distributor = ] ignore_distributor Identificato solo a scopo informativo. Non supportata. Non è garantita la compatibilità con le versioni future.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot Riconosce che l'azione eseguita da questo stored procedure può invalidare uno snapshot esistente. force_invalidate_snapshot è un bit, con un valore predefinito di 0.

0 specifica che le modifiche apportate all'articolo non causano l'invalido dello snapshot. Se la stored procedure rileva che la modifica richiede un nuovo snapshot, viene generato un errore e non viene apportata alcuna modifica.

1 specifica che le modifiche apportate all'articolo possono causare l'invalido dello snapshot e, se sono presenti sottoscrizioni esistenti che richiedono un nuovo snapshot, concede l'autorizzazione per l'eliminazione dello snapshot esistente come obsoleto e la generazione di un nuovo snapshot.

[ @publisher = ] 'publisher'Specifica un oggetto non Microsoft SQL Server Publisher. publisher è sysname, con il valore predefinito NULL.

Nota

Publisher non deve essere usato quando si modificano le proprietà dell'articolo in un SQL Server Publisher.

[ @from_drop_publication = ] from_drop_publication Identificato solo a scopo informativo. Non supportata. Non è garantita la compatibilità con le versioni future.

Valori del codice restituito

0 (esito positivo) o 1 (errore)

Commenti

sp_droparticle viene usato nella replica snapshot e transazionale.

Per gli articoli filtrati orizzontalmente, sp_droparticle la colonna type dell'articolo nella tabella sysarticles (Transact-SQL) per determinare se deve essere eliminata anche una vista o un filtro. Se sono disponibili viste o filtri generati in modo automatico, questi vengono eliminati insieme all'articolo. Le viste e i filtri creati in modo manuale non vengono eliminati.

L'sp_droparticle per eliminare un articolo da una pubblicazione non rimuove l'oggetto dal database di pubblicazione o dall'oggetto corrispondente dal database di sottoscrizione. Utilizzare DROP <object> per rimuovere manualmente questi oggetti, se necessario.

Esempio

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @article = N'Product'; 

-- Drop the transactional article.
USE [AdventureWorks2012]
EXEC sp_droparticle 
  @publication = @publication, 
  @article = @article,
  @force_invalidate_snapshot = 1;
GO

Autorizzazioni

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

Vedere anche

Eliminare un articolo
Aggiungere ed eliminare articoli in pubblicazioni esistenti
sp_addarticle (Transact-SQL)
sp_changearticle (Transact-SQL)
sp_helparticle (Transact-SQL)
sp_helparticlecolumns (Transact-SQL)
Stored procedure per la replica (Transact-SQL)