sp_dropmergearticle (Transact-SQL)

Entfernt einen Artikel aus einer Mergepublikation. Diese gespeicherte Prozedur wird beim Verleger mit der Publikationsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

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 ]

Argumente

• [ @publication=] 'publication'
  Der Name der Publikation, aus der ein Artikel gelöscht werden soll. publicationist vom Datentyp sysname und hat keinen Standardwert.

• [ @article=] 'article'
  Der Name des Artikels, der aus der angegebenen Publikation gelöscht werden soll. articleist vom Datentyp sysname und hat keinen Standardwert. Mit all werden alle vorhandenen Artikel in der angegebenen Mergepublikation entfernt. Selbst wenn all für article angegeben wird, muss die Publikation separat aus dem Artikel gelöscht werden.

• [ @ignore_distributor = ] ignore_distributor
  Gibt an, ob diese gespeicherte Prozedur ausgeführt wird, ohne dass eine Verbindung mit dem Verteiler hergestellt wird. ignore_distributor ist vom Datentyp bit und hat den Standardwert 0.

• [ @reserved=] reserved
  Ist für zukünftige Zwecke reserviert. reserved ist vom Datentyp nvarchar(20) und hat den Standardwert NULL.

• [ @force_invalidate_snapshot = ] force_invalidate_snapshot
  Aktiviert oder deaktiviert die Möglichkeit, einen Snapshot für ungültig zu erklären. force_invalidate_snapshot ist vom Datentyp bit und hat den Standardwert 0.

  Durch 0 wird angegeben, dass der Snapshot nicht durch Änderungen am Mergeartikel ungültig werden kann.

  Der Wert 1 gibt an, dass Änderungen am Mergeartikel bewirken können, dass der Snapshot ungültig wird. Wenn dies zutrifft, erteilt der Wert 1 die Berechtigung für das Auftreten des neuen Snapshots.

• [ @force_reinit_subscription = ] force_reinit_subscription
  Bestätigt, dass das Löschen des Artikels die erneute Initialisierung vorhandener Abonnements erfordert. force_reinit_subscription ist vom Datentyp bit und hat den Standardwert 0.

  Durch 0 wird angegeben, dass das Abonnement nicht durch das Löschen des Artikels erneut initialisiert werden kann.

  Der Wert 1 gibt an, dass vorhandene Abonnements durch das Löschen des Artikels erneut initialisiert werden können. Außerdem wird mit diesem Wert die Berechtigung zur erneuten Initialisierung der Abonnements erteilt.

• [ @ignore_merge_metadata= ] ignore_merge_metadata
  Nur interne Verwendung.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_dropmergefilter wird für die Mergereplikation verwendet. Weitere Informationen zum Löschen von Artikeln finden Sie unter Hinzufügen und Löschen von Artikeln bei vorhandenen Publikationen.

Durch das Ausführen von sp_dropmergearticle zum Löschen eines Artikels aus einer Publikation wird das Objekt nicht aus der Publikationsdatenbank bzw. das entsprechende Objekt nicht aus der Abonnementdatenbank entfernt. Verwenden Sie DROP <object>, um diese Objekte bei Bedarf manuell zu entfernen.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder der festen Datenbankrolle db_owner können sp_dropmergearticle ausführen.

Beispiel

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

Siehe auch

Verweis

sp_addmergearticle (Transact-SQL)
sp_changemergearticle (Transact-SQL)
sp_helpmergearticle (Transact-SQL)
Gespeicherte Replikationsprozeduren (Transact-SQL)

Andere Ressourcen

How to: Delete an Article (Replication Transact-SQL Programming)
Hinzufügen und Löschen von Artikeln bei vorhandenen Publikationen

Hilfe und Informationen

Informationsquellen für SQL Server 2005