sp_changearticle (Transact-SQL)

Gilt für: SQL Server Azure SQL Managed Instance

Ändert die Eigenschaften eines Artikels in einer Transaktions- oder Momentaufnahmeveröffentlichung. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @publication = ] N'Publikation'

Der Name der Publikation, die den Artikel enthält. @publication ist "sysname" mit der Standardeinstellung "NULL.

[ @article = ] N'article'

Der Name des Artikels, dessen Eigenschaft geändert werden soll. @article ist "sysname" mit der Standardeinstellung "NULL.

[ @property = ] N'property'

Eine zu ändernde Artikeleigenschaft. @property ist nvarchar(100), wobei die Standardeinstellung istNULL.

[ @value = ] N'value'

Der neue Wert der Artikeleigenschaft. @value ist nvarchar(255), mit einem Standardwert von NULL.

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 Artikel 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 Gibt an, dass Änderungen am Artikel dazu führen können, dass die Momentaufnahme ungültig ist. 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 Artikel nicht dazu führen, dass das Abonnement erneut initialisiert wird. Wenn die gespeicherte Prozedur erkennt, dass die Änderung erfordert, dass vorhandene Abonnements erneut initialisiert werden, tritt ein Fehler auf, und es werden keine Änderungen vorgenommen.

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

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

[ @publisher = ] N'publisher'

Gibt einen Nicht-SQL Server-Herausgeber an. @publisher ist "sysname" mit der Standardeinstellung "NULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_changearticle wird in der Momentaufnahmereplikation und Transaktionsreplikation verwendet.

Wenn ein Artikel zu einer Publikation gehört, die peer-to-Peer-Transaktionsreplikation unterstützt, können Sie nur die descriptionEigenschaften , ins_cmd, , upd_cmdund del_cmd die Eigenschaften ändern.

Das Ändern einer 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:

• del_cmd
• dest_table
• destination_owner
• ins_cmd
• pre_creation_cmd
• schema_options
• upd_cmd

Das Ändern einer 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.

• del_cmd
• dest_table
• destination_owner
• filter
• ins_cmd
• status
• upd_cmd

Innerhalb einer vorhandenen Publikation können Sie einen Artikel ändern sp_changearticle , ohne die gesamte Publikation ablegen und erneut erstellen zu müssen.

Gültige Schemaoptionen

In der folgenden Tabelle werden die zulässigen Werte schema_option basierend auf dem Replikationstyp (oben dargestellt) und dem Artikeltyp (unten in der ersten Spalte) beschrieben.

Beispiele

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
DECLARE @option AS int;
SET @publication = N'AdvWorksProductTran';
SET @article = N'Product';
SET @option = (SELECT CAST(0x0000000002030073 AS int));

-- Change the schema options to replicate schema with XML.
USE [AdventureWorks2022]
EXEC sp_changearticle 
  @publication = @publication,
  @article = @article, 
  @property = N'schema_option', 
  @value = @option,
  @force_invalidate_snapshot = 1;
GO

Berechtigungen

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

Zugehöriger Inhalt

• Anzeigen und Ändern von Artikeleigenschaften
• Ändern von Veröffentlichungs- und Artikeleigenschaften
• sp_addarticle (Transact-SQL)
• sp_articlecolumn (Transact-SQL)
• sp_droparticle (Transact-SQL)
• sp_helparticle (Transact-SQL)
• sp_helparticlecolumns (Transact-SQL)