sp_changemergearticle (Transact-SQL)

Gilt für: SQL Server

Ändert die Eigenschaften eines Mergeartikels. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_changemergearticle
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
[ ; ]

Argumente

[ @publication = ] N'Publikation'

Der Name der Publikation, in der der Artikel vorhanden ist. @publication ist "sysname" ohne Standard.

[ @article = ] N'article'

Der Name des zu ändernden Artikels. @article ist "sysname" ohne Standard.

[ @property = ] N'property'

Die Eigenschaft, die für den angegebenen Artikel und die publikation geändert werden soll. @property ist "sysname" und kann einer der werte sein, die in der folgenden Tabelle aufgeführt sind.

[ @value = ] N'value'

Der neue Wert für die angegebene Eigenschaft. @value ist nvarchar(2000) und kann einer der werte sein, die in der folgenden Tabelle aufgeführt sind.

Diese Tabelle beschreibt die Eigenschaften von Artikeln und die Werte für diese Eigenschaften.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Bestätigt, dass die von dieser gespeicherten Prozedur ausgeführte Aktion möglicherweise eine vorhandene Momentaufnahme ungültig macht. @force_invalidate_snapshot ist bit, mit einem Standardwert von 0.

• 0 Gibt an, dass Änderungen am Seriendruckartikel nicht dazu führen, dass die Momentaufnahme ungültig ist. Wenn die gespeicherte Prozedur erkennt, dass die Änderungen eine neue Momentaufnahme erfordern, tritt ein Fehler auf und es werden keine Änderungen vorgenommen.

• 1 bedeutet, dass Änderungen am Seriendruckartikel dazu führen können, dass die Momentaufnahme ungültig ist, und wenn vorhandene Abonnements vorhanden sind, die eine neue Momentaufnahme erfordern würden, erteilen Sie die Berechtigung, dass die vorhandene Momentaufnahme als veraltet markiert und eine neue Momentaufnahme generiert wird.

Im Abschnitt "Hinweise" finden Sie die Eigenschaften, die beim Ändern die Generierung einer neuen Momentaufnahme erfordern.

[ @force_reinit_subscription = ] force_reinit_subscription

Bestätigt, dass die von dieser gespeicherten Prozedur ausgeführte Aktion möglicherweise das erneute Initialisieren von vorhandenen Abonnements erfordert. @force_reinit_subscription ist bit, mit einem Standardwert von 0.

• 0 Gibt an, dass Änderungen am Seriendruckartikel nicht dazu führen, dass das Abonnement erneut initialisiert wird. Wenn die gespeicherte Prozedur erkennt, dass die Änderung die Neuinitialisierung vorhandener Abonnements erfordert, tritt ein Fehler auf, und es werden keine Änderungen durchgeführt.

• 1 bedeutet, dass Änderungen am Seriendruckartikel dazu führen, dass vorhandene Abonnements erneut initialisiert werden und die Berechtigung für die Erneute Initialisierung des Abonnements erteilt werden.

Im Abschnitt "Hinweise" finden Sie die Eigenschaften, die bei änderung erforderlich sind, dass alle vorhandenen Abonnements erneut initialisiert werden.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_changemergearticle wird in der Seriendruckreplikation verwendet.

Da sp_changemergearticle verwendet wird, um Artikeleigenschaften zu ändern, die ursprünglich mithilfe von sp_addmergearticle angegeben wurden, finden Sie unter sp_addmergearticle weitere Informationen zu diesen Eigenschaften.

Das Ändern der folgenden Eigenschaften erfordert, dass eine neue Momentaufnahme generiert wird, und Sie müssen einen Wert 1 für den parameter @force_invalidate_snapshot angeben:

• check_permissions
• column_tracking
• destination_owner
• pre_creation_command
• schema_options
• subset_filterclause

Das Ändern der folgenden Eigenschaften erfordert, dass vorhandene Abonnements erneut initialisiert werden, und Sie müssen einen Wert 1 für den parameter @force_reinit_subscription angeben:

• check_permissions
• column_tracking
• destination_owner
• pre_creation_command
• identityrangemanagementoption
• subscriber_upload_options
• subset_filterclause
• creation_script
• schema_option
• logical_record_level_conflict_detection
• logical_record_level_conflict_resolution

Wenn Sie einen Wert für 3 partition_options" angeben, werden Metadaten bereinigt, wenn die Merge-Agent ausgeführt wird und die partitionierte Momentaufnahme schneller abläuft. Beim Verwenden dieser Option sollten Sie in Erwägung ziehen, vom Abonnenten angeforderte partitionierte Momentaufnahmen zu aktivieren. Weitere Informationen finden Sie unter Erstellen einer Momentaufnahme für eine Mergeveröffentlichung mit parametrisierten Filtern.

Wenn Sie die column_tracking Eigenschaft festlegen, wenn die Tabelle bereits in anderen Zusammenführungspublikationen veröffentlicht wurde, muss die Spaltennachverfolgung mit dem Wert übereinstimmen, der von vorhandenen Artikeln basierend auf dieser Tabelle verwendet wird. Dieser Parameter ist nur für Tabellenartikel spezifisch.

Wenn mehrere Publikationen Artikel basierend auf derselben zugrunde liegenden Tabelle veröffentlichen, bewirkt das Ändern der delete_tracking Eigenschaft oder der compensate_for_errors Eigenschaft für einen Artikel die gleiche Änderung an den anderen Artikeln, die auf derselben Tabelle basieren.

Wenn das vom Zusammenführungsprozess verwendete Publisher-Anmelde-/Benutzerkonto nicht über die richtigen Tabellenberechtigungen verfügt, werden die ungültigen Änderungen als Konflikte protokolliert.

Wenn Sie den Wert ändern schema_option, führt das System keine bitweise Aktualisierung durch. Dies bedeutet, dass vorhandene Biteinstellungen möglicherweise deaktiviert werden, wenn Sie die Verwendung verwenden schema_option sp_changemergearticle. Um die vorhandenen Einstellungen beizubehalten, sollten Sie zwischen dem Wert, den Sie festlegen, und dem aktuellen Wert schema_optionausführen, der durch Ausführen sp_helpmergearticle bestimmt werden kann.

Gültige Schemaoptionstabelle

In der folgenden Tabelle werden die zulässigen schema_option Werte je nach Artikeltyp beschrieben.

Beispiele

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @article = N'SalesOrderHeader';

-- Enable column-level conflict tracking.
-- Changing this property requires that existing subscriptions
-- be reinitialized and that a new snapshot be generated.
USE [AdventureWorks2022]
EXEC sp_changemergearticle 
  @publication = @publication,
  @article = @article, 
  @property = N'column_tracking', 
  @value = N'true',
  @force_invalidate_snapshot = 1,
  @force_reinit_subscription = 1;
GO

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder db_owner feste Datenbankrolle können ausgeführt werden sp_changemergearticle.

Zugehöriger Inhalt

• Anzeigen und Ändern von Artikeleigenschaften
• Ändern von Veröffentlichungs- und Artikeleigenschaften
• sp_addmergearticle (Transact-SQL)
• sp_dropmergearticle (Transact-SQL)
• sp_helpmergearticle (Transact-SQL)
• Gespeicherte Replikationsprozeduren (Transact-SQL)