sp_changemergepublication (Transact-SQL)
Ändert die Eigenschaften einer Mergeveröffentlichung. Diese gespeicherte Prozedur wird beim Verleger mit der Veröffentlichungsdatenbank ausgeführt.
.gif "Themenlink (Symbol)")
Syntax
sp_changemergepublication [ @publication= ] 'publication'
[ , [ @property= ] 'property' ]
[ , [ @value= ] 'value' ]
[ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
[ , [ @force_reinit_subscription = ] force_reinit_subscription ]
Argumente
[ @publication=\] 'publication'
Der Name der Veröffentlichung. publication ist ein Wert vom Datentyp sysname und hat keinen Standardwert.[ @property=\] 'property'
Die Eigenschaft, die für die angegebene Veröffentlichung geändert werden soll. property ist ein Wert vom Datentyp sysname. Die in der Tabelle aufgeführten Werte sind möglich.[ @value=\] 'value'
Der neue Wert für die angegebene Eigenschaft. value ist ein Wert vom Datentyp nvarchar(255). Die in der folgenden Tabelle aufgeführten Werte sind möglich.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
Anonyme Abonnements sind zulässig.
false
Anonyme Abonnements sind nicht zulässig.
allow_partition_realignment
true
Löschvorgänge werden an den Abonnenten gesendet, um die Ergebnisse einer Partitionsänderung widerzuspiegeln, indem Daten entfernt werden, die nicht mehr Bestandteil der Partition des Abonnenten sind. Dies ist das Standardverhalten.
false
Daten einer alten Partition verbleiben auf dem Abonnenten. Änderungen an diesen Daten auf dem Verleger werden nicht an diesen Abonnenten repliziert. Stattdessen werden auf dem Abonnenten vorgenommene Änderungen an den Verleger repliziert. Auf diese Weise werden Daten in einem Abonnement aus einer alten Partition beibehalten, wenn die Daten noch benötigt werden.
allow_pull
true
Pullabonnements sind für die angegebene Veröffentlichung zulässig.
false
Pullabonnements sind für die angegebene Veröffentlichung nicht zulässig.
allow_push
true
Pushabonnements sind für die angegebene Veröffentlichung zulässig.
false
Pushabonnements sind für die angegebene Veröffentlichung nicht zulässig.
allow_subscriber_initiated_snapshot
true
Der Abonnent kann den Snapshotprozess initiieren.
false
Der Abonnent kann den Snapshotprozess nicht initiieren.
allow_subscription_copy
true
Sie können die Abonnementdatenbanken kopieren, die diese Veröffentlichung abonniert haben.
false
Sie können die Abonnementdatenbanken, die diese Veröffentlichung abonniert haben, nicht kopieren.
allow_synctoalternate
true
Lässt einen alternativen Synchronisierungspartner für die Synchronisierung mit diesem Verleger zu.
false
Lässt keinen alternativen Synchronisierungspartner für die Synchronisierung mit diesem Verleger zu.
allow_web_synchronization
true
Abonnements können über HTTPS synchronisiert werden.
false
Abonnements können nicht über HTTPS synchronisiert werden.
alt_snapshot_folder
Gibt den Speicherort des alternativen Ordners für den Snapshot an.
automatic_reinitialization_policy
1
Änderungen werden vor der Neuinitialisierung vom Abonnenten hochgeladen.
0
Das Abonnement wird erneut initialisiert, ohne die Änderungen vorher hochzuladen.
centralized_conflicts
true
Alle Konfliktdatensätze werden auf dem Verleger gespeichert. Wenn Sie diese Eigenschaft ändern, müssen vorhandene Abonnenten erneut initialisiert werden.
false
Konfliktdatensätze werden auf dem Server gespeichert, der bei der Konfliktauflösung verloren hat. Wenn Sie diese Eigenschaft ändern, müssen vorhandene Abonnenten erneut initialisiert werden.
compress_snapshot
true
Der Snapshot in einem alternativen Snapshotordner wird in das CAB-Format komprimiert. Der Snapshot im Standardsnapshotordner kann nicht komprimiert werden. Für das Ändern dieser Eigenschaft ist ein neuer Snapshot erforderlich.
false
Standardmäßig wird der Snapshot nicht komprimiert. Für das Ändern dieser Eigenschaft ist ein neuer Snapshot erforderlich.
conflict_logging
publisher
Die Konfliktdatensätze werden auf dem Verleger gespeichert.
subscriber
Die Konfliktdatensätze werden auf dem Abonnenten gespeichert, der den Konflikt verursacht hat. Dies wird für SQL Server Compact 3.5 SP2-Abonnenten nicht unterstützt.
both
Die Konfliktdatensätze werden auf dem Verleger und auf dem Abonnenten gespeichert.
conflict_retention
int gibt die Beibehaltungsdauer in Tagen an, für die Konflikte beibehalten werden. Die Festlegung von conflict_retention auf 0 bedeutet, dass kein Konfliktcleanup erforderlich ist.
description
Die Beschreibung der Veröffentlichung.
dynamic_filters
true
Die Veröffentlichung wird anhand einer dynamischen Klausel gefiltert.
false
Die Veröffentlichung wird nicht dynamisch gefiltert.
enabled_for_internet
true
Die Veröffentlichung ist für das Internet aktiviert. File Transfer Protocol (FTP) kann verwendet werden, um die Snapshotdateien an einen Abonnenten zu übertragen. Die Synchronisierungsdateien für die Veröffentlichung werden im Verzeichnis C:\Programme\Microsoft SQL Server\MSSQL\Repldata\ftp gespeichert.
false
Die Veröffentlichung ist nicht für das Internet aktiviert.
ftp_address
Die Netzwerkadresse des FTP-Diensts für den Verteiler. Gibt an, wo die Snapshotdateien für die Veröffentlichung gespeichert werden.
ftp_login
Der Benutzername, mit dem eine Verbindung mit dem FTP-Dienst hergestellt wird.
ftp_password
Das Benutzerkennwort, mit dem eine Verbindung zum FTP-Dienst hergestellt wird.
ftp_port
Die Nummer des Anschlusses für den FTP-Dienst des Verteilers. Gibt die TCP-Anschlussnummer der FTP-Site an, in der die Snapshotdateien für die Veröffentlichung gespeichert werden.
ftp_subdirectory
Gibt an, wo die Snapshotdateien erstellt werden, wenn die Veröffentlichung das Verteilen von Snapshots mithilfe von FTP unterstützt.
generation_leveling_threshold
int
Gibt die Anzahl der Änderungen an, die in einer Generierung enthalten sind. Eine Generierung ist eine Auflistung von Änderungen, die an einen Verleger oder Abonnenten übermittelt werden. Weitere Informationen finden Sie unter Funktionsweise der Nachverfolgung und der Enumeration bei der Mergereplikation.
keep_partition_changes
true
Die Synchronisierung wird optimiert, und es sind nur Abonnenten betroffen, die über Zeilen in den geänderten Partitionen verfügen. Für das Ändern dieser Eigenschaft ist ein neuer Snapshot erforderlich.
false
Die Synchronisierung wird nicht optimiert, und die an Abonnenten gesendeten Partitionen werden überprüft, wenn sich Daten in einer Partition ändern. Für das Ändern dieser Eigenschaft ist ein neuer Snapshot erforderlich.
max_concurrent_merge
Ist vom Datentyp int und stellt die maximale Anzahl gleichzeitiger Mergeprozesse dar, die für eine Mergeveröffentlichung ausgeführt werden können. Bei 0 gibt es keine Beschränkung. Wenn die gleichzeitige Ausführung von mehr Mergeprozessen geplant ist, werden die überschüssigen Aufträge in eine Warteschlange eingereiht, in der diese darauf warten, dass ein aktuell ausgeführter Mergeprozess beendet wird.
max_concurrent_dynamic_snapshots
Ist vom Datentyp int und stellt die maximale Anzahl gleichzeitiger Snapshotsitzungen zum Generieren eines Snapshots mit gefilterten Daten dar, die gleichzeitig für eine Mergeveröffentlichung ausgeführt werden können, die parametrisierte Zeilenfilter verwendet. Im Fall von 0 liegt keine Beschränkung vor. Wenn die gleichzeitige Ausführung von mehr Snapshotprozessen geplant ist, werden die überschüssigen Aufträge in eine Warteschlange eingereiht, bis ein aktueller Mergeprozess beendet wird.
post_snapshot_script
Gibt einen Zeiger auf einen Speicherort für .sql-Dateien an. Der Verteilungs-Agent oder der Merge-Agent führt post_snapshot_script aus, nachdem alle andere Skripts für replizierte Objekte und Daten während der Erstsynchronisierung angewendet wurden. Für das Ändern dieser Eigenschaft ist ein neuer Snapshot erforderlich.
pre_snapshot_script
Gibt einen Zeiger auf einen Speicherort für .sql-Dateien an. Der Merge-Agent führt pre_snapshot_script vor allen Skripts für replizierte Objekte aus, wenn der Snapshot auf einem Abonnenten angewendet wird. Für das Ändern dieser Eigenschaft ist ein neuer Snapshot erforderlich.
publication_compatibility_level
100RTM
SQL Server 2008
90RTM
SQL Server 2005
80SP3
SQL Server 2000 SP3
80SP2
SQL Server 2000 SP2
80SP1
SQL Server 2000 SP2
80RTM
SQL Server 2000
70 SP4
SQL Server 7.0 SP4
70SP3
SQL Server 7.0 SP3
70SP2
SQL Server 7.0 SP2
70SP1
SQL Server 7.0 SP1
70RTM
SQL Server 7.0
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 Active Directory nicht länger Veröffentlichungsinformationen hinzufügen.
false
Entfernt die Veröffentlichungsinformationen aus Active Directory.
replicate_ddl
1
Auf dem Verleger ausgeführte Anweisungen der Datendefinitionssprache (DDL, Data Definition Language) werden repliziert.
0
DDL-Anweisungen werden nicht repliziert.
retention
Ist vom Datentyp int und stellt die Anzahl von retention_period_unit-Einheiten dar, für die Änderungen für die angegebene Veröffentlichung gespeichert werden sollen. Wenn das Abonnement nicht innerhalb der Beibehaltungsdauer synchronisiert wird und die ausstehenden Änderungen von einem Cleanupvorgang auf dem Verteiler entfernt wurden, läuft das Abonnement ab und muss erneut initialisiert werden. Die maximal zulässige Beibehaltungsdauer entspricht der Anzahl von Tagen zwischen dem 31. Dezember 9999 und dem aktuellen Datum.
.gif "Hinweis")
Hinweis
Für die Beibehaltungsdauer von Mergeveröffentlichungen gilt eine Kulanzfrist von 24 Stunden, um Abonnenten in verschiedenen Zeitzonen zu unterstützen.retention_period_unit
day
Die Beibehaltungsdauer wird in Tagen angegeben.
week
Die Beibehaltungsdauer wird in Wochen angegeben.
month
Die Beibehaltungsdauer wird in Monaten angegeben.
year
Die Beibehaltungsdauer wird in Jahren angegeben.
snapshot_in_defaultfolder
true
Snapshotdateien werden im Standardsnapshotordner gespeichert.
false
Snapshotdateien werden am alternativen Speicherort gespeichert, der durch alt_snapshot_folder angegeben wird. Diese Kombination gibt an, dass die Snapshotdateien sowohl im Standardspeicherort als auch in alternativen Speicherorten gespeichert werden.
snapshot_ready
true
Der Snapshot für die Veröffentlichung ist verfügbar.
false
Der Snapshot für die Veröffentlichung ist nicht verfügbar.
status
active
Die Veröffentlichung weist einen aktiven Status auf.
inactive
Die Veröffentlichung weist einen inaktiven Status auf.
sync_mode
native oder
bcp native
Massenkopierprogramm-Ausgabe aller Tabellen im systemeigenen Modus wird für Anfangssnapshot verwendet.
character
oder bcp character
Massenkopierprogramm-Ausgabe aller Tabellen im Zeichenmodus wird für Anfangssnapshot verwendet. Dies ist für alle Nicht-SQL Server-Abonnenten erforderlich.
use_partition_groups
Hinweis
Wenn Sie nach der Verwendung von partition_groups erneut setupbelongs verwenden und use_partition_groups=false in changemergearticle festlegen, wird dies nach Aufnahme eines Snapshots unter Umständen nicht korrekt dargestellt. Die Trigger, die vom Snapshot generiert werden, sind mit Partitionsgruppen kompatibel. Sie können dieses Problem umgehen, indem Sie den Status auf Inaktiv festlegen, use_partition_groups ändern und den Status dann auf Aktiv festlegen.true
Die Veröffentlichung verwendet vorausberechnete Partitionen.
false
Die Veröffentlichung verwendet keine vorausberechneten Partitionen.
validate_subscriber_info
Listet die Funktionen auf, die zum Abrufen von Abonnenteninformationen verwendet werden. Überprüft anschließend die dynamischen Filterkriterien, die für den Abonnenten verwendet werden, um zu überprüfen, dass die Informationen konsistent partitioniert werden.
web_synchronization_url
Der Standardwert für die Internet-URL, die für die Websynchronisierung verwendet wird.
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 ist 0.Mit dem Wert 0 wird angegeben, dass der Snapshot nicht durch Änderungen an der Veröffentlichung 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.
Mit dem Wert 1 wird angegeben, dass der Snapshot durch Änderungen an der Veröffentlichung 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 mit den Hinweisen.
[ @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 ist 0.Mit dem Wert 0 wird angegeben, dass Abonnements nicht durch Änderungen an der Veröffentlichung erneut initialisiert werden müssen. Wenn die gespeicherte Prozedur erkennt, dass die Änderung die erneute Initialisierung von vorhandenen Abonnements erfordert, tritt ein Fehler auf und es werden keine Änderungen ausgeführt.
Der Wert 1 gibt an, dass Änderungen an der Veröffentlichung die erneute Initialisierung vorhandener Abonnements bewirken. Außerdem wird mit diesem Wert die Berechtigung zur erneuten Initialisierung des Abonnements erteilt.
Weitere Informationen zu den Eigenschaften, bei deren Änderung die erneute Initialisierung aller vorhandenen Abonnements erforderlich ist, finden Sie im Abschnitt "Hinweise".
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Hinweise
sp_changemergepublication wird bei der Mergereplikation verwendet.
Das Ändern der folgenden Eigenschaften erfordert die Generierung eines neuen Snapshots. Sie müssen den Wert 1 für den force_invalidate_snapshot-Parameter angeben.
alt_snapshot_folder
compress_snapshot
dynamic_filters
ftp_address
ftp_login
ftp_password
ftp_port
ftp_subdirectory
post_snapshot_script
publication_compatibility_level (nur zu 80SP3)
pre_snapshot_script
snapshot_in_defaultfolder
sync_mode
use_partition_groups
Für das Ändern der folgenden Eigenschaften ist eine erneute Initialisierung von vorhandenen Abonnements erforderlich. Sie müssen den Wert 1 für den force_reinit_subscription-Parameter angeben.
dynamic_filters
validate_subscriber_info
Das SQL Server-Objekt muss bereits in Active Directory erstellt sein, um Veröffentlichungsobjekte mithilfe von publish_to_active_directory aufzulisten.
Beispiel
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
-- Disable DDL replication for the publication.
USE [AdventureWorks2008R2]
EXEC sp_changemergepublication
@publication = @publication,
@property = N'replicate_ddl',
@value = 0,
@force_invalidate_snapshot = 0,
@force_reinit_subscription = 0;
GO
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin oder der festen Datenbankrolle db_owner können sp_changemergepublication ausführen.
Siehe auch