sp_changearticle (Transact-SQL)

Gilt für:SQL ServerAzure 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= ] 'publication' ]  
    [ , [ @article= ] 'article' ]  
    [ , [ @property= ] 'property' ]  
    [ , [ @value= ] 'value' ]  
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]  
    [ , [ @publisher = ] 'publisher' ]  

Argumente

[ @publication = ] 'publication' Ist der Name der Publikation, die den Artikel enthält. publikation ist sysname, mit einem Standardwert von NULL.

[ @article = ] 'article' Ist der Name des Artikels, dessen Eigenschaft geändert werden soll. Der Artikel ist "sysname" mit der Standardeinstellung NULL.

[ @property = ] 'property' Ist eine Artikeleigenschaft, die geändert werden soll. property is nvarchar(100).

[ @value = ] 'value' Ist der neue Wert der Artikeleigenschaft. wert ist nvarchar(255).

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

[ @force_invalidate_snapshot = ] force_invalidate_snapshotErkennt an, dass die von dieser gespeicherten Prozedur ausgeführte Aktion eine vorhandene Momentaufnahme ungültig macht. force_invalidate_Momentaufnahme ist ein bisschen mit der Standardeinstellung 0.

0 gibt an, dass Änderungen am Artikel nicht dazu führen, dass die Momentaufnahme ungültig sind. 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 sind, und wenn es vorhandene Abonnements gibt, die eine neue Momentaufnahme erfordern, die Berechtigung erteilt, dass die vorhandenen Momentaufnahme als veraltet gekennzeichnet werden und eine neue Momentaufnahme generiert wird.

Weitere Informationen zu den Eigenschaften, bei deren Änderung die Generierung einer neuen Momentaufnahme erforderlich ist, finden Sie im Abschnitt "Hinweise".

[ @force_reinit_subscription = ]force_reinit_subscription_ Erkennt an, dass die von dieser gespeicherten Prozedur ausgeführte Aktion möglicherweise erfordert, dass vorhandene Abonnements erneut initialisiert werden. force_reinit_subscription ist ein bisschen mit der Standardeinstellung 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 die Neuinitialisierung vorhandener Abonnements erfordert, tritt ein Fehler auf, und es werden keine Änderungen durchgeführt.

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.

Weitere Informationen zu den Eigenschaften, bei deren Änderung die erneute Initialisierung aller vorhandenen Abonnements erforderlich ist, finden Sie im Abschnitt "Hinweise".

[ @publisher = ] 'publisher' Gibt einen Nicht-SQL Server-Herausgeber an. Publisher ist "sysname" mit dem Standardwert NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_changearticle wird in Momentaufnahme Replikation und Transaktionsreplikation verwendet.

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

Zum Ändern einer der folgenden Eigenschaften muss eine neue Momentaufnahme generiert werden, und Sie müssen einen Wert von 1 für den parameter force_invalidate_Momentaufnahme angeben:

• del_cmd

• dest_table

• destination_owner

• ins_cmd

• pre_creation_cmd

• schema_options

• upd_cmd

Wenn Sie eine der folgenden Eigenschaften ändern, müssen vorhandene Abonnements erneut initialisiert werden, und Sie müssen für den Parameter force_reinit_subscription einen Wert von 1 angeben.

• del_cmd

• dest_table

• destination_owner

• filter

• ins_cmd

• status

• upd_cmd

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

Valid Schema Options

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.

Beispiel

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 sp_changearticle ausgeführt werden.

Weitere Informationen

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)