Artikel
03/30/2012

sp_changepublication (Transact-SQL)

Ändert die Eigenschaften einer Veröffentlichung. Diese gespeicherte Prozedur wird beim Verleger mit der Veröffentlichungsdatenbank ausgeführt.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

sp_changepublication [ [ @publication = ] 'publication' ]
    [ , [ @property = ] 'property' ]
    [ , [ @value = ] 'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @publisher = ] 'publisher' ]

Argumente

[ @publication = ] 'publication'
Der Name der Veröffentlichung. publication ist ein Wert vom Datentyp sysname. Der Standardwert lautet NULL.
[ @property = ] 'property'
Die zu ändernde Veröffentlichungseigenschaft. property ist vom Datentyp nvarchar(255).

[ @value = ] 'value'
Der neue Wert der Eigenschaft. value ist vom Datentyp nvarchar(255). Der Standardwert lautet NULL.

Diese Tabelle beschreibt die änderbaren Eigenschaften der Veröffentlichung sowie die Einschränkungen für die Werte dieser Eigenschaften.

Eigenschaft	Wert	Beschreibung
allow_anonymous	true	Für die Veröffentlichung können anonyme Abonnements erstellt werden, und immediate_sync muss ebenfalls den Wert true haben. Kann für Peer-to-Peer-Veröffentlichungen nicht geändert werden.
	false	Anonyme Abonnements können für die Veröffentlichung nicht erstellt werden. Kann für Peer-to-Peer-Veröffentlichungen nicht geändert werden.
allow_initialize_from_backup	true	Abonnenten können ein Abonnement für diese Veröffentlichung aus einer Sicherung statt aus einem Anfangssnapshot initialisieren. Diese Eigenschaft kann für Nicht-Microsoft SQL Server-Veröffentlichungen nicht geändert werden.
	false	Abonnenten müssen den Anfangssnapshot verwenden. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
allow_partition_switch	true	ALTER TABLE…SWITCH-Anweisungen können für die veröffentlichte Datenbank ausgeführt werden. Weitere Informationen finden Sie unter Replizieren partitionierter Tabellen und Indizes.
	false	ALTER TABLE…SWITCH-Anweisungen können nicht für die veröffentlichte Datenbank ausgeführt werden.
allow_pull	true	Pullabonnements sind für die angegebene Veröffentlichung zulässig. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
	false	Pullabonnements sind für die Veröffentlichung nicht zulässig. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
allow_push	true	Pushabonnements sind für die angegebene Veröffentlichung zulässig.
	false	Pushabonnements sind für die Veröffentlichung nicht zulässig.
allow_subscription_copy	true	Aktiviert die Möglichkeit zum Kopieren von Datenbanken, die diese Veröffentlichung abonnieren. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
	false	Deaktiviert die Möglichkeit zum Kopieren von Datenbanken, die diese Veröffentlichung abonnieren. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
alt_snapshot_folder		Der Speicherort des alternativen Ordners für den Snapshot.
centralized_conflicts	true	Die Konfliktdatensätze werden auf dem Verleger gespeichert. Kann nur geändert werden, wenn keine aktiven Abonnements vorhanden sind. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
	false	Die Konfliktdatensätze werden auf dem Verleger und auf dem Abonnenten gespeichert, der den Konflikt verursacht hat. Kann nur geändert werden, wenn keine aktiven Abonnements vorhanden sind. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
compress_snapshot	true	Der Snapshot in einem alternativen Snapshotordner wird in das CAB-Dateiformat komprimiert. Der Snapshot im Standardsnapshotordner kann nicht komprimiert werden.
	false	Der Snapshot wird nicht komprimiert. Dies ist das Standardverhalten für die Replikation.
conflict_policy	pub wins	Richtlinie zur Konfliktlösung für das Aktualisieren von Abonnenten, bei der der Verleger den Konflikt gewinnt. Diese Eigenschaft kann nur geändert werden, wenn keine aktiven Abonnements vorhanden sind. Wird für Oracle-Verleger nicht unterstützt.
	sub reinit	Wenn beim Aktualisieren von Abonnenten ein Konflikt auftritt, muss das Abonnement erneut initialisiert werden. Diese Eigenschaft kann nur geändert werden, wenn keine aktiven Abonnements vorhanden sind. Wird für Oracle-Verleger nicht unterstützt.
	sub wins	Richtlinie zur Konfliktlösung für das Aktualisieren von Abonnenten, bei der der Abonnent den Konflikt gewinnt. Diese Eigenschaft kann nur geändert werden, wenn keine aktiven Abonnements vorhanden sind. Wird für Oracle-Verleger nicht unterstützt.
conflict_retention		Ein Wert vom Datentyp int, der die Konfliktaufbewahrungsdauer in Tagen angibt. Die Standardaufbewahrungsdauer beträgt 14 Tage. 0 bedeutet, dass kein Konfliktcleanup notwendig ist. Wird für Oracle-Verleger nicht unterstützt.
description		Eine optionale Beschreibung der Veröffentlichung.
enabled_for_het_sub	true	Ermöglicht es der Veröffentlichung, Nicht-SQL Server-Abonnenten zu unterstützen. enabled_for_het_sub kann nicht geändert werden, wenn Abonnements für die Veröffentlichung vorhanden sind. Möglicherweise müssen Sie sp_changepublication (Transact-SQL) ausführen, um den folgenden Anforderungen zu entsprechen, bevor Sie enabled_for_het_sub auf true festlegen: allow_queued_tran muss den Wert false aufweisen. allow_sync_tran muss den Wert false haben. Durch das Ändern von enabled_for_het_sub in true werden möglicherweise vorhandene Veröffentlichungseinstellungen geändert. Weitere Informationen finden Sie unter Nicht-SQL Server-Abonnenten. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
	false	Die Veröffentlichung unterstützt Nicht-SQL Server-Abonnenten nicht. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
enabled_for_internet	true	Die Veröffentlichung ist für das Internet aktiviert. FTP (File Transfer Protocol) kann dazu verwendet werden, die Snapshotdateien an einen Abonnenten zu übermitteln. Die Synchronisierungsdateien für die Veröffentlichung werden im folgenden Verzeichnis gespeichert: C:\Programme\Microsoft SQL Server\MSSQL\Repldata\ftp. ftp_address kann nicht NULL sein. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
	false	Die Veröffentlichung ist nicht für das Internet aktiviert. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
enabled_for_p2p	true	Die Veröffentlichung unterstützt die Peer-to-Peer-Replikation. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden. Für das Festlegen von enabled_for_p2p auf true gelten die folgenden Einschränkungen: allow_anonymous muss den Wert false haben. allow_dts muss den Wert false haben. allow_initialize_from_backup muss den Wert true haben. allow_queued_tran muss den Wert false aufweisen. allow_sync_tran muss den Wert false haben. enabled_for_het_sub muss den Wert false haben. independent_agent muss den Wert true haben. repl_freq muss den Wert continuous haben. replicate_ddl muss den Wert 1 haben.
	false	Die Veröffentlichung unterstützt die Peer-to-Peer-Replikation nicht. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
ftp_address		Der Speicherort der Veröffentlichungssnapshotdateien, auf den über FTP zugegriffen werden kann. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
ftp_login		Der Benutzername, mit dem eine Verbindung mit dem FTP-Dienst hergestellt wird. Der Wert ANONYMOUS ist zulässig. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
ftp_password		Das Kennwort für den Benutzernamen, mit dem eine Verbindung mit dem FTP-Dienst hergestellt wird. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
ftp_port		Die Nummer des Anschlusses für den FTP-Dienst des Verteilers. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
ftp_subdirectory		Gibt an, wo die Snapshotdateien erstellt werden, wenn die Veröffentlichung das Verteilen von Snapshots mithilfe von FTP unterstützt. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
immediate_sync	true	Die Synchronisierungsdateien für die Veröffentlichung werden bei jeder Ausführung des Snapshot-Agents erstellt oder neu erstellt. Abonnenten können die Synchronisierungsdateien unmittelbar nach der Abonnierung erhalten, wenn der Snapshot-Agent vor der Abonnierung abgeschlossen wurde. Neue Abonnements rufen die neuesten Synchronisierungsdateien ab, die von der letzten Ausführung des Snapshot-Agents generiert wurden. independent_agent muss ebenfalls den Wert true haben.
	false	Synchronisierungsdateien werden nur erstellt, wenn neue Abonnements vorhanden sind. Abonnenten können die Synchronisierungsdateien nach dem Einrichten des Abonnements erst empfangen, wenn die Snapshot-Agents gestartet und abgeschlossen wurden.
independent_agent	true	Die Veröffentlichung verfügt über ihren eigenen dedizierten Verteilungs-Agent.
	false	Die Veröffentlichung verwendet einen freigegebenen Verteilungs-Agent, und jedes Paar aus Veröffentlichungsdatenbank und Abonnementdatenbank verfügt über einen freigegebenen Agent.
p2p_continue_onconflict	true	Der Verteilungs-Agent setzt bei Erkennung eines Konflikts die Verarbeitung von Änderungen fort. Vorsicht Es wird empfohlen, den Standardwert FALSE zu verwenden. Wenn diese Option auf TRUE festgelegt wird, versucht der Verteilungs-Agent, die Datenkonvergenz in der Topologie herbeizuführen, indem die konfliktverursachende Zeile von dem Knoten mit der höchsten Absender-ID angewendet wird. Bei dieser Methode ist keine Konvergenz garantiert. Sie sollten sicherstellen, dass die Topologie nach der Erkennung eines Konflikts konsistent ist. Weitere Informationen finden Sie im Abschnitt "Konfliktbehandlung" unter Konflikterkennung bei der Peer-to-Peer-Replikation.
	false	Der Verteilungs-Agent beendet bei Erkennung eines Konflikts die Verarbeitung von Änderungen.
post_snapshot_script		Gibt den Speicherort einer Skriptdatei von Transact-SQL an, die der Verteilungs-Agent ausführt, nachdem alle anderen Skripts für replizierte Objekte und Daten während der Anfangssynchronisierung angewendet wurden.
pre_snapshot_script		Gibt den Speicherort einer Skriptdatei von Transact-SQL an, die der Verteilungs-Agent ausführt, bevor alle anderen Skripts für replizierte Objekte und Daten während der Anfangssynchronisierung angewendet wurden.
publish_to_ActiveDirectory	true	Dieser Parameter wurde als veraltet markiert und wird nur aus Gründen der Abwärtskompatibilität von Skripts unterstützt. Sie können Microsoft Active Directory nicht länger Veröffentlichungsinformationen hinzufügen.
	false	Entfernt die Veröffentlichungsinformationen aus Active Directory.
queue_type	sql	Zum Speichern von Transaktionen wird SQL Server verwendet. Diese Eigenschaft kann nur geändert werden, wenn keine aktiven Abonnements vorhanden sind. Hinweis Die Unterstützung für das Verwenden von Microsoft Message Queuing wurde eingestellt. Das Angeben des Werts msmq für value führt zu einem Fehler.
repl_freq	continuous	Veröffentlicht die Ausgabe aller protokollbasierten Transaktionen.
	snapshot	Veröffentlicht nur geplante Synchronisierungsereignisse.
replicate_ddl	1	Auf dem Verleger ausgeführte Anweisungen der Datendefinitionssprache (DDL, Data Definition Language) werden repliziert. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden.
	0	DDL-Anweisungen werden nicht repliziert. Diese Eigenschaft kann für Nicht-SQL Server-Veröffentlichungen nicht geändert werden. Die Replikation von Schemaänderungen kann nicht deaktiviert werden, wenn Peer-to-Peer-Replikation verwendet wird.
replicate_partition_switch	true	ALTER TABLE…SWITCH-Anweisungen, die für die veröffentlichte Datenbank ausgeführt werden, sollten auf Abonnenten repliziert werden. Diese Option ist nur gültig, wenn allow_partition_switch auf TRUE festgelegt wurde. Weitere Informationen finden Sie unter Replizieren partitionierter Tabellen und Indizes.
	false	ALTER TABLE…SWITCH-Anweisungen sollten nicht auf Abonnenten repliziert werden.
retention		Ein Wert vom Datentyp int, der die Aufbewahrungsdauer für Abonnementaktivitäten in Stunden darstellt. Wenn ein Abonnement innerhalb der Beibehaltungsdauer nicht aktiv ist, wird es entfernt.
snapshot_in_defaultfolder	true	Snapshotdateien werden im Standardsnapshotordner gespeichert. Ist alt_snapshot_folderebenfalls angegeben, werden Snapshotdateien sowohl am Standardspeicherort als auch am alternativen Speicherort gespeichert.
	false	Snapshotdateien werden am alternativen Speicherort gespeichert, der durch alt_snapshot_folder angegeben wird.
status	active	Veröffentlichungsdaten sind für Abonnenten sofort beim Erstellen der Veröffentlichung verfügbar. Wird für Oracle-Verleger nicht unterstützt.
	inactive	Veröffentlichungsdaten sind für Abonnenten nicht beim Erstellen der Veröffentlichung verfügbar. Wird für Oracle-Verleger nicht unterstützt.
sync_method	native	Verwendet beim Synchronisieren von Abonnements eine Massenkopierausgabe aller Tabellen im systemeigenen Modus.
	character	Verwendet beim Synchronisieren von Abonnements eine Massenkopierausgabe aller Tabellen im Zeichenmodus.
	concurrent	Verwendet eine Massenkopierprogramm-Ausgabe aller Tabellen im systemeigenen Modus, sperrt jedoch die Tabellen beim Generieren des Snapshots nicht. Nicht für die Snapshotreplikation gültig.
	concurrent_c	Verwendet eine Massenkopierprogramm-Ausgabe aller Tabellen im Zeichenmodus, sperrt jedoch die Tabellen beim Generieren des Snapshots nicht. Nicht für die Snapshotreplikation gültig.
taskid		Diese Eigenschaft wurde als veraltet markiert und wird nicht mehr unterstützt.
NULL (Standard)		Gibt die Liste unterstützter Werte für property zurück.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot
Bestätigt, dass die von dieser gespeicherten Prozedur ausgeführte Aktion einen vorhandenen Snapshot für ungültig erklären kann. force_invalidate_snapshot ist ein Wert vom Datentyp bit. Der Standardwert lautet 0.

Durch 0 wird angegeben, dass der Snapshot nicht durch Änderungen am Artikel ungültig werden kann. Wenn die gespeicherte Prozedur erkennt, dass die Änderungen einen neuen Snapshot erfordern, tritt ein Fehler auf und es werden keine Änderungen vorgenommen.

Durch 1 wird angegeben, dass der Snapshot durch Änderungen am Artikel ungültig werden kann. Wenn Abonnements vorhanden sind, die einen neuen Snapshot erfordern würden, wird mit diesem Wert die Berechtigung erteilt, den vorhandenen Snapshot als veraltet zu markieren und einen neuen Snapshot zu generieren.

Weitere Informationen zu den Eigenschaften, bei deren Änderung die Generierung eines neuen Snapshots erforderlich ist, finden Sie im Abschnitt "Hinweise".
[@force_reinit_subscription = ] force_reinit_subscription
Bestätigt, dass die von dieser gespeicherten Prozedur ausgeführte Aktion die erneute Initialisierung vorhandener Abonnements erfordern kann. force_reinit_subscription ist vom Datentyp bit. Der Standardwert lautet 0.

Durch 0 wird angegeben, dass das Abonnement nicht durch Änderungen am Artikel erneut initialisiert werden kann. Wenn die gespeicherte Prozedur erkennt, dass die Änderung die erneute Initialisierung von vorhandenen Abonnements erfordert, tritt ein Fehler auf und es werden keine Änderungen durchgeführt.

Der Wert 1 gibt an, dass Änderungen am Artikel die erneute Initialisierung vorhandener Abonnements bewirken. Außerdem wird mit diesem Wert die Berechtigung zur erneuten Initialisierung des Abonnements erteilt.
[ @publisher = ] 'publisher'
Gibt einen Nicht-SQL Server-Verleger an. publisher ist ein Wert vom Datentyp sysname und besitzt den Standardwert NULL.

Hinweis

publisher sollte nicht beim Ändern von Artikeleigenschaften für einen SQL Server-Verleger verwendet werden.

Hinweis
publisher sollte nicht beim Ändern von Artikeleigenschaften für einen SQL Server-Verleger verwendet werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_changepublication wird bei der Snapshot- und Transaktionsreplikation verwendet.

Das Ändern der folgenden Eigenschaften erfordert die Generierung eines neuen Snapshots, und Sie müssen einen Wert von 1 für den force_invalidate_snapshot-Parameter angeben.

alt_snapshot_folder
compress_snapshot
enabled_for_het_sub
ftp_address
ftp_login
ftp_password
ftp_port
ftp_subdirectory
post_snapshot_script
pre_snapshot_script
snapshot_in_defaultfolder
sync_mode

Das SQL Server-Objekt muss bereits in Active Directory erstellt sein, um Veröffentlichungsobjekte mithilfe des publish_to_active_directory-Parameters aufzulisten.

Beispiel

DECLARE @publication AS sysname
SET @publication = N'AdvWorksProductTran' 

-- Turn off DDL replication for the transactional publication.
USE [AdventureWorks2008R2]
EXEC sp_changepublication 
  @publication = @publication, 
  @property = N'replicate_ddl', 
  @value = 0
GO

Berechtigungen

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

Siehe auch

sp_changepublication (Transact-SQL)

Syntax

Argumente

Rückgabecodewerte

Hinweise

Beispiel

Berechtigungen

Siehe auch

Aufgaben

Verweis

Konzepte

Zusätzliche Ressourcen