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.
| Eigenschaft | Werte | Beschreibung |
|---|---|---|
creation_script |
Pfad und Name eines Artikelschemaskripts, mit dem Zieltabellen erstellt werden. Der Standardwert ist NULL. |
|
del_cmd |
DELETE auszuführende Anweisung; andernfalls wird sie aus dem Protokoll erstellt. |
|
description |
Ein neuer Beschreibungseintrag für den Artikel. | |
dest_object |
Dieser Parameter wird aus Gründen der Abwärtskompatibilität bereitgestellt. Verwenden Sie dest_table. |
|
dest_table |
Die neue Zieltabelle. | |
destination_owner |
Name des Besitzers des Zielobjekts. | |
filter |
Die neue gespeicherte Prozedur, mit der die Tabelle gefiltert werden soll (horizontales Filtern). Der Standardwert ist NULL. Kann für Publikationen in peer-to-Peer-Replikation nicht geändert werden. |
|
fire_triggers_on_snapshot |
true |
Replizierte Benutzertrigger werden ausgeführt, wenn die Anfangsmomentaufnahme angewendet wird. Hinweis: Damit Trigger repliziert werden können, muss der Bitmaskenwert schema_option des Werts 0x100enthalten sein. |
false |
Replizierte Benutzertrigger werden nicht ausgeführt, wenn die anfängliche Momentaufnahme angewendet wird. | |
identity_range |
Steuert die Größe der zugeordneten Identitätsbereiche, die am Abonnent zugeordnet wurden. Wird für die Peer-zu-Peer-Replikation nicht unterstützt. | |
ins_cmd |
INSERT auszuführende Anweisung; andernfalls wird sie aus dem Protokoll erstellt. |
|
pre_creation_cmd |
Precreation command that can drop, delete, or truncate the destination table before sync is applied. | |
none |
Verwendet keinen Befehl. | |
drop |
Entfernt die Zieltabelle. | |
delete |
Löscht die Zieltabelle. | |
truncate |
Schneidet die Zieltabelle ab. | |
pub_identity_range |
Steuert die Größe der zugeordneten Identitätsbereiche, die am Abonnent zugeordnet wurden. Wird für die Peer-zu-Peer-Replikation nicht unterstützt. | |
schema_option |
Gibt die Bitmap der Schemagenerierungsoption für den angegebenen Artikel an. schema_option ist binary(8). Weitere Informationen finden Sie im Abschnitt Hinweise. |
|
0x00 |
Beschreibt die Skripterstellung durch den Momentaufnahme-Agent. | |
0x01 |
Generiert die Objekterstellung (CREATE TABLE, CREATE PROCEDUREusw.). |
|
0x02 |
Generiert die gespeicherten Prozeduren, die Änderungen für den Artikel weitergeben (falls definiert). | |
0x04 |
Identitätsspalten werden mithilfe der IDENTITY Eigenschaft skripted. |
|
0x08 |
Replizieren von Zeitstempelspalten . Wenn nicht festgelegt, werden Zeitstempelspalten als binär repliziert. | |
0x10 |
Generiert einen entsprechenden gruppierten Index. | |
0x20 |
Konvertiert benutzerdefinierte Datentypen (UDT) auf dem Abonnenten in Basisdatentypen. Diese Option kann nicht verwendet werden, wenn für eine UDT-Spalte eine CHECK DEFAULT Einschränkung vorhanden ist, wenn eine UDT-Spalte Teil des Primärschlüssels ist oder eine berechnete Spalte auf eine UDT-Spalte verweist. Diese Option wird für Oracle-Verleger nicht unterstützt. |
|
0x40 |
Generiert entsprechende nicht gruppierte Indizes. | |
0x80 |
Schließt die deklarative referenzielle Integrität für die Primärschlüssel ein. | |
0x100 |
Repliziert Benutzertrigger für einen Tabellenartikel, wenn definiert. | |
0x200 |
FOREIGN KEY Repliziert Einschränkungen. Wenn die referenzierte Tabelle nicht Teil einer Publikation ist, werden alle FOREIGN KEY Einschränkungen für eine veröffentlichte Tabelle nicht repliziert. |
|
0x400 |
CHECK Repliziert Einschränkungen. |
|
0x800 |
Repliziert Standards. | |
0x1000 |
Repliziert die Sortierung auf Spaltenebene. | |
0x2000 |
Repliziert erweiterte Eigenschaften, die dem Quellobjekt des veröffentlichten Artikels zugeordnet sind. | |
0x4000 |
Repliziert eindeutige Schlüssel, wenn auf einem Tabellenartikel definiert. | |
0x8000 |
Repliziert Primärschlüssel und eindeutige Schlüssel in einem Tabellenartikel als Einschränkungen mithilfe von ALTER TABLE Anweisungen.Hinweis: Diese Option ist veraltet. Verwenden Sie stattdessen 0x80 und 0x4000. |
|
0x10000 |
CHECK Repliziert Einschränkungen, NOT FOR REPLICATION sodass die Einschränkungen während der Synchronisierung nicht erzwungen werden. |
|
0x20000 |
FOREIGN KEY Repliziert Einschränkungen, NOT FOR REPLICATION sodass die Einschränkungen während der Synchronisierung nicht erzwungen werden. |
|
0x40000 |
Repliziert Dateigruppen, die mit einer partitionierten Tabelle oder einem Index verbunden sind. | |
0x80000 |
Repliziert das Partitionsschema für eine partitionierte Tabelle. | |
0x100000 |
Repliziert das Partitionsschema für einen partitionierten Index. | |
0x200000 |
Repliziert Tabellenstatistiken. | |
0x400000 |
Standardbindungen. | |
0x800000 |
Regelbindungen. | |
0x1000000 |
Volltextindex. | |
0x2000000 |
XML-Schemaauflistungen, die an XML-Spalten gebunden sind, werden nicht repliziert. | |
0x4000000 |
Repliziert Indizes in XML-Spalten . | |
0x8000000 |
Legt Schemas an, die auf dem Abonnent noch nicht vorhanden sind. | |
0x10000000 |
Konvertiert XML-Spalten in "ntext" für den Abonnenten. | |
0x20000000 |
Konvertiert große Objektdatentypen (nvarchar(max), varchar(max) und varbinary(max)), die in SQL Server 2005 (9.x) eingeführt wurden, in Datentypen, die in SQL Server 2000 (8.x) unterstützt werden. | |
0x40000000 |
Berechtigungen für die Replikation. | |
0x80000000 |
Versuchen Sie, Abhängigkeiten von Objekten abzulegen, die nicht Teil der Publikation sind. | |
0x100000000 |
Verwenden Sie diese Option, um das FILESTREAM Attribut zu replizieren, wenn es in varbinary(max) -Spalten angegeben ist. Geben Sie diese Option nicht an, wenn Sie Tabellen in SQL Server 2005 (9.x)-Abonnenten replizieren. Das Replizieren von Tabellen mit FILESTREAM-Spalten auf SQL Server 2000 (8.x) Abonnenten wird unabhängig davon, wie diese Schemaoption festgelegt wird, nicht unterstützt.Siehe verwandte Option 0x800000000. |
|
0x200000000 |
Konvertiert Datums- und Uhrzeitdatentypen (Datum, Uhrzeit, Datetimeoffset und Datetime2), die in SQL Server 2008 (10.0.x) eingeführt wurden, in Datentypen, die in früheren Versionen von SQL Server unterstützt werden. | |
0x400000000 |
Repliziert die Komprimierungsoption für Daten und Indizes. Weitere Informationen finden Sie unter Datenkomprimierung. | |
0x800000000 |
Legen Sie diese Option fest, um FILESTREAM-Daten in einer eigenen Dateigruppe auf dem Abonnenten zu speichern. Wenn diese Option nicht festgelegt ist, werden FILESTREAM-Daten in der Standarddateigruppe gespeichert. Die Replikation erstellt keine Dateigruppen; Wenn Sie diese Option festlegen, müssen Sie daher die Dateigruppe erstellen, bevor Sie die Momentaufnahme beim Abonnenten anwenden. Weitere Informationen zum Erstellen von Objekten, bevor Sie die Momentaufnahme anwenden, finden Sie unter Execute Scripts Before and After the Snapshot Is Applied. Siehe verwandte Option 0x100000000. |
|
0x1000000000 |
Wandelt benutzerdefinierte Typen (Common Language Runtime, CLR) um, die größer als 8.000 Byte sind, in varbinary(max) um, sodass Spalten vom Typ UDT in Abonnenten repliziert werden können, die SQL Server 2005 (9.x) ausführen. | |
0x2000000000 |
Wandelt den hierarchyid-Datentyp in varbinary(max) um, sodass Spalten der Typhierarchie-ID in Abonnenten repliziert werden können, die SQL Server 2005 (9.x) ausführen. Weitere Informationen zur Verwendung von Hierarchie-ID-Spalten in replizierten Tabellen finden Sie in der Referenz zur Hierarchie-Datentypmethode. | |
0x4000000000 |
Repliziert die gefilterten Indizes in der Tabelle. Weitere Informationen zu gefilterten Indizes finden Sie unter Erstellen gefilterter Indizes. | |
0x8000000000 |
Wandelt die Geografie - und Geometriedatentypen in varbinary(max) um, sodass Spalten dieser Typen in Abonnenten repliziert werden können, die SQL Server 2005 (9.x) ausführen. | |
0x10000000000 |
Repliziert Indizes für Spalten vom Typ "Geografie " und "Geometrie". | |
0x20000000000 |
Repliziert das SPARSE Attribut für Spalten. Weitere Informationen zu diesem Attribut finden Sie unter Verwenden von Spalten mit geringem Wert. |
|
0x40000000000 |
Aktivieren Sie skripting durch den Snapshot-Agent, um eine speicheroptimierte Tabelle für den Abonnenten zu erstellen. | |
0x80000000000 |
Konvertiert gruppierten Index in nicht gruppierten Index für speicheroptimierte Artikel. | |
status |
Gibt den neuen Status der Eigenschaft an. | |
dts horizontal partitions |
Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt. | |
include column names |
Spaltennamen sind in der replizierten INSERT Anweisung enthalten. |
|
no column names |
Spaltennamen sind in der replizierten INSERT Anweisung nicht enthalten. |
|
no dts horizontal partitions |
Die horizontale Partition für den Artikel wird nicht durch ein transformierbares Abonnement definiert. | |
none |
Löscht alle Statusoptionen in der Sysarticles-Tabelle und markiert den Artikel als inaktiv. | |
parameters |
Änderungen werden an den Abonnenten mit parametrisierten Befehlen weitergegeben. Dies ist die Standardeinstellung für einen neuen Artikel. | |
string literals |
Änderungen werden an den Abonnenten mit Werten von Literalzeichenfolgen weitergegeben. | |
sync_object |
Der Name der Tabelle oder Sicht, mit der eine Synchronisierungsausgabedatei erstellt wird. Der Standardwert ist NULL. Diese Option wird für Oracle-Verleger nicht unterstützt. |
|
tablespace |
Gibt den Tabellenbereich an, der von der Protokollierungstabelle für einen Artikel verwendet wird, der von einer Oracle-Datenbank veröffentlicht wird. Weitere Informationen finden Sie unter Verwalten von Oracle-Tabellenbereichen. | |
threshold |
Der Prozentwert, der steuert, wann der Verteilungs-Agent einen neuen Identitätsbereich zuweist. Wird für die Peer-zu-Peer-Replikation nicht unterstützt. | |
type |
Diese Option wird für Oracle-Verleger nicht unterstützt. | |
logbased |
Protokollbasierter Artikel. | |
logbased manualboth |
Protokollbasierter Artikel mit manuell erstelltem Filter und manuell erstellter Sicht. Für diese Option müssen Sie auch die sync_object Eigenschaften filter festlegen. Diese Option wird für Oracle-Verleger nicht unterstützt. |
|
logbased manualfilter |
Protokollbasierter Artikel mit manuell erstelltem Filter. Für diese Option müssen Sie auch die sync_object Eigenschaften filter festlegen. Diese Option wird für Oracle-Verleger nicht unterstützt. |
|
logbased manualview |
Protokollbasierter Artikel mit manuell erstellter Sicht. Für diese Option müssen Sie auch die sync_object Eigenschaft festlegen. Diese Option wird für Oracle-Verleger nicht unterstützt. |
|
indexed viewlogbased |
Artikel für protokollbasierte indizierte Sicht. Diese Option wird für Oracle-Verleger nicht unterstützt. Für diesen Artikeltyp muss die Basistabelle nicht separat veröffentlicht werden. | |
indexed viewlogbased manualboth |
Artikel für protokollbasierte indizierte Sicht mit manuell erstelltem Filter und manuell erstellter Sicht. Für diese Option müssen Sie auch die sync_object Eigenschaften filter festlegen. Für diesen Artikeltyp muss die Basistabelle nicht separat veröffentlicht werden. Diese Option wird für Oracle-Verleger nicht unterstützt. |
|
indexed viewlogbased manualfilter |
Artikel für protokollbasierte indizierte Sicht mit manuell erstelltem Filter. Für diese Option müssen Sie auch die sync_object Eigenschaften filter festlegen. Für diesen Artikeltyp muss die Basistabelle nicht separat veröffentlicht werden. Diese Option wird für Oracle-Verleger nicht unterstützt. |
|
indexed viewlogbased manualview |
Artikel für protokollbasierte indizierte Sicht mit manuell erstellter Sicht. Für diese Option müssen Sie auch die sync_object Eigenschaft festlegen. Für diesen Artikeltyp muss die Basistabelle nicht separat veröffentlicht werden. Diese Option wird für Oracle-Verleger nicht unterstützt. |
|
upd_cmd |
UPDATE auszuführende Anweisung; andernfalls wird sie aus dem Protokoll erstellt. |
|
NULL |
NULL |
Gibt eine Liste von Artikeleigenschaften zurück, die geändert werden können. |
[ @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.
Hinweis
Publisher sollte nicht verwendet werden, wenn Artikeleigenschaften in einem SQL Server-Publisher geändert werden.
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_cmddest_tabledestination_ownerins_cmdpre_creation_cmdschema_optionsupd_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_cmddest_tabledestination_ownerfilterins_cmdstatusupd_cmd
Innerhalb einer vorhandenen Publikation können Sie einen Artikel ändern sp_changearticle , ohne die gesamte Publikation ablegen und erneut erstellen zu müssen.
Hinweis
Beim Ändern des Werts schema_optionführt das System keine bitweise Aktualisierung durch. Dies bedeutet, dass vorhandene Biteinstellungen möglicherweise deaktiviert werden, wenn Sie die Verwendung verwenden schema_option sp_changearticle. Um die vorhandenen Einstellungen beizubehalten, sollten Sie | (Bitweise ODER) zwischen dem Wert, den Sie festlegen, und dem aktuellen Wert von schema_option, der durch Ausführen sp_helparticle bestimmt werden kann.
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.
| Artikeltyp | Replikationstyp – Transaktionstyp | Replikationstyp – Momentaufnahme |
|---|---|---|
logbased |
Alle Optionen | Alle Optionen, aber 0x02 |
logbased manualfilter |
Alle Optionen | Alle Optionen, aber 0x02 |
logbased manualview |
Alle Optionen | Alle Optionen, aber 0x02 |
indexed view logbased |
Alle Optionen | Alle Optionen, aber 0x02 |
indexed view logbased manualfilter |
Alle Optionen | Alle Optionen, aber 0x02 |
indexed view logbased manualview |
Alle Optionen | Alle Optionen, aber 0x02 |
indexed view logbase manualboth |
Alle Optionen | Alle Optionen, aber 0x02 |
proc exec |
0x01, 0x20, 0x20000x20000000x8000000x400000, 0x8000000, , 0x10000000, , 0x20000000, und 0x400000000x80000000 |
0x01, 0x20, 0x20000x20000000x8000000x400000, 0x8000000, , 0x10000000, , 0x20000000, und 0x400000000x80000000 |
serializable proc exec |
0x01, 0x20, 0x20000x20000000x8000000x400000, 0x8000000, , 0x10000000, , 0x20000000, und 0x400000000x80000000 |
0x01, 0x20, 0x20000x20000000x8000000x400000, 0x8000000, , 0x10000000, , 0x20000000, und 0x400000000x80000000 |
proc schema only |
0x01, 0x20, 0x20000x20000000x8000000x400000, 0x8000000, , 0x10000000, , 0x20000000, und 0x400000000x80000000 |
0x01, 0x20, 0x20000x20000000x8000000x400000, 0x8000000, , 0x10000000, , 0x20000000, und 0x400000000x80000000 |
view schema only |
0x01, 0x010, , 0x020, 0x040, 0x20000x01000x40000, 0x100000, 0x200000, und 0x4000000x8000000x20000000x80000000x400000000x80000000 |
0x01, 0x010, , 0x020, 0x040, 0x20000x01000x40000, 0x100000, 0x200000, und 0x4000000x8000000x20000000x80000000x400000000x80000000 |
func schema only |
0x01, 0x20, 0x20000x20000000x8000000x400000, 0x8000000, , 0x10000000, , 0x20000000, und 0x400000000x80000000 |
0x01, 0x20, 0x20000x20000000x8000000x400000, 0x8000000, , 0x10000000, , 0x20000000, und 0x400000000x80000000 |
indexed view schema only |
0x01, 0x010, , 0x020, 0x040, 0x20000x01000x40000, 0x100000, 0x200000, und 0x4000000x8000000x20000000x80000000x400000000x80000000 |
0x01, 0x010, , 0x020, 0x040, 0x20000x01000x40000, 0x100000, 0x200000, und 0x4000000x8000000x20000000x80000000x400000000x80000000 |
Hinweis
Für das Aktualisieren von 0x80 Publikationen in die Warteschlange muss der schema_option Wert aktiviert sein. Die unterstützten schema_option Werte für Nicht-SQL Server-Publikationen sind: 0x01, , 0x02, 0x10, , 0x40und 0x1000 0x800x4000.
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.