Artikel
03/30/2012

sp_helpmergepublication (Transact-SQL)

Gibt Informationen zu einer Mergeveröffentlichung zurück. Diese gespeicherte Prozedur wird auf dem Verleger mit der Veröffentlichungsdatenbank ausgeführt.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

sp_helpmergepublication [ [ @publication = ] 'publication' ]
    [ , [ @found = ] 'found' OUTPUT ]
    [ , [ @publication_id = ] 'publication_id' OUTPUT ]
    [ , [ @reserved = ] 'reserved' ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @publisher_db = ] 'publisher_db' ]

Argumente

[ @publication = ] 'publication'
Der Name der Veröffentlichung. publication ist vom Datentyp sysname. Der Standardwert lautet %, womit Informationen zu allen Mergeveröffentlichungen in der aktuellen Datenbank zurückgegeben werden.
[ @found = ] 'found' OUTPUT
Ein Flag zur Angabe zurückgegebener Zeilen. foundist vom Datentyp int und ein OUTPUT-Parameter mit dem Standardwert NULL. 1 gibt an, dass die Veröffentlichung gefunden wurde. 0 gibt an, dass die Veröffentlichung nicht gefunden wurde.
[ @publication_id**=**\] **'**publication_id' OUTPUT
Die ID der Veröffentlichung. publication_id ist vom Datentyp uniqueidentifier und ein OUTPUT-Parameter mit dem Standardwert NULL.
[ @reserved**=**\] 'reserved'
Nur für Informationszwecke identifiziert. Nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt. reserved ist ein Wert vom Datentyp nvarchar(20). Der Standardwert lautet NULL.
[ @publisher**=** ] 'publisher'
Der Name des Verlegers. publisher ist ein Wert vom Datentyp sysname mit dem Standardwert NULL.
[@publisher_db = ] 'publisher_db'
Der Name der Veröffentlichungsdatenbank. publisher_db ist vom Datentyp sysname und hat den Standardwert NULL.

Resultsets

Spaltenname	Datentyp	Beschreibung
id	int	Sequenzielle Position der Veröffentlichung in der Liste im Resultset.
name	sysname	Name der Veröffentlichung.
description	nvarchar(255)	Die Beschreibung der Veröffentlichung.
status	tinyint	Gibt an, wann Veröffentlichungsdaten verfügbar sind.
retention	int	Die Zeit, die Metadaten zu Änderungen in Artikeln in der Veröffentlichung gespeichert werden sollen. Die Einheiten für diesen Zeitraum kann Tage, Wochen, Monate oder Jahre sein. Informationen zu Einheiten finden Sie in der retention_period_unit-Spalte.
sync_mode	tinyint	Synchronisierungsmodus dieser Veröffentlichung. 0 = Systemeigenes Massenkopierprogramm (Hilfsprogramm bcp) 1 = Massenkopieren von Zeichen
allow_push	int	Bestimmt, ob für die angegebene Veröffentlichung Pushabonnements erstellt werden können. 0 bedeutet, dass ein Pushabonnement nicht zulässig ist.
allow_pull	int	Bestimmt, ob für die angegebene Veröffentlichung Pullabonnements erstellt werden können. 0 bedeutet, dass ein Pullabonnement nicht zulässig ist.
allow_anonymous	int	Bestimmt, ob für die angegebene Veröffentlichung anonyme Abonnements erstellt werden können. 0 bedeutet, dass ein anonymes Abonnement nicht zulässig ist.
centralized_conflicts	int	Legt fest, ob Konfliktdatensätze auf dem angegebenen Verleger gespeichert werden: 0 = Die Konfliktdatensätze werden sowohl auf dem den Konflikt verursachenden Verleger als auch auf dem Abonnenten gespeichert. 1 = Alle Konfliktdatensätze werden auf dem Verleger gespeichert.
priority	float(8)	Priorität des Loopbackabonnements.
snapshot_ready	tinyint	Gibt an, ob die Momentaufnahme dieser Veröffentlichung einsatzbereit ist. 0 = Momentaufnahme kann verwendet werden. 1 = Momentaufnahme kann nicht verwendet werden.
publication_type	int	Typ der Veröffentlichung: 0 = Momentaufnahme. 1 = Transaktionsveröffentlichung. 2 = Mergeveröffentlichung.
pubid	uniqueidentifier	Eindeutiger Bezeichner dieser Veröffentlichung.
snapshot_jobid	binary(16)	Auftrags-ID des Momentaufnahme-Agents. Um den Eintrag für den Momentaufnahmeauftrag in der sysjobs-Systemtabelle zu erhalten, müssen Sie diesen Hexadezimalwert in uniqueidentifier konvertieren.
enabled_for_internet	int	Legt fest, ob die Veröffentlichung für das Internet aktiviert ist. Bei 1 werden die Synchronisierungsdateien für die Veröffentlichung im Verzeichnis C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp gespeichert. Der Benutzer muss das FTP-Verzeichnis (File Transfer Protocol) erstellen. Bei 0 ist die Veröffentlichung nicht für den Internetzugriff aktiviert.
dynamic_filter	int	Gibt an, ob ein parametrisierter Zeilenfilter verwendet wird. 0 bedeutet, dass kein parametrisierter Zeilenfilter verwendet wird.
has_subscription	bit	Gibt an, ob die Veröffentlichung über Abonnements verfügt. 0 gibt an, dass derzeit keine Abonnements für diese Veröffentlichung vorliegen.
snapshot_in_default_folder	bit	Legt fest, ob die Momentaufnahmedateien im Standardordner gespeichert werden. Bei 1 befinden sich die Momentaufnahmedateien im Standardordner. Bei 0 werden Momentaufnahmedateien am alternativen Speicherort gespeichert, der durch alt_snapshot_folder angegeben wird. Alternative Speicherorte können sich auf einem anderen Server, auf einem Netzlaufwerk oder auf einem Wechselmedium (z. B. CD-ROM oder Wechseldatenträger) befinden. Momentaufnahmedateien lassen sich auch in einer FTP-Site speichern, um zu einem späteren Zeitpunkt vom Abonnenten abgerufen zu werden. Hinweis Dieser Parameter kann den Wert true besitzen, und trotzdem kann eine Position im Parameter alt_snapshot_folder angegeben sein. Diese Kombination gibt an, dass die Momentaufnahmedateien sowohl an den Standardspeicherorten als auch an den alternativen Standorten gespeichert werden.
alt_snapshot_folder	nvarchar(255)	Gibt den Speicherort des anderen Ordners für die Momentaufnahme an.
pre_snapshot_script	nvarchar(255)	Gibt einen Zeiger auf eine .sql-Datei an, die der Merge-Agent vor allen replizierten Objektskripts ausführt, wenn er die Momentaufnahme auf einem Abonnenten anwendet.
post_snapshot_script	nvarchar(255)	Gibt einen Zeiger auf eine .sql-Datei an, die der Merge-Agent ausführt, nachdem alle anderen replizierten Objektskripts und -daten während einer anfänglichen Synchronisierung angewendet wurden.
compress_snapshot	bit	Gibt an, dass die Momentaufnahme, die an den Speicherort alt_snapshot_folder geschrieben wird, in das CAB-Format von Microsoft komprimiert wird.
ftp_address	sysname	Die Netzwerkadresse des FTP-Diensts für den Verteiler. Gibt an, wo die Veröffentlichungs-Momentaufnahmedateien zum Abholen durch den Merge-Agent gespeichert sind.
ftp_port	int	Die Portnummer des FTP-Diensts für den Verteiler. ftp_port hat den Standardwert 21. Gibt an, wo die Veröffentlichungs-Momentaufnahmedateien zum Abholen durch den Merge-Agent gespeichert sind.
ftp_subdirectory	nvarchar(255)	Gibt an, wo die Veröffentlichungs-Momentaufnahmedateien zum Abholen durch den Merge-Agent gespeichert sind, wenn die Momentaufnahme mithilfe von FTP übermittelt wird.
ftp_login	sysname	Der Benutzername, mit dem eine Verbindung zum FTP-Dienst hergestellt wird.
conflict_retention	int	Gibt die Aufbewahrungsdauer in Tagen an, für die Konflikte beibehalten werden. Wenn die angegebene Anzahl von Tagen abgelaufen ist, wird die Konfliktzeile aus der Konflikttabelle gelöscht.
keep_partition_changes	int	Gibt an, ob für diese Veröffentlichung eine Synchronisierungsoptimierung erfolgt. keep_partition_changes hat den Standardwert 0. Der Wert 0 bedeutet, dass die Synchronisierung nicht optimiert wird und die an alle Abonnenten gesendeten Partitionen überprüft werden, wenn sich Daten in einer Partition ändern. 1 bedeutet, dass die Synchronisierung optimiert wird und nur Abonnenten betroffen sind, die über Zeilen in der geänderten Partition verfügen. Hinweis Standardmäßig verwenden Mergeveröffentlichungen vorausberechnete Partitionen, die ein höheres Optimierungsmaß ermöglichen als diese Option. Weitere Informationen finden Sie unter Parametrisierte Zeilenfilter und Optimieren der Leistung parametrisierter Filter mithilfe vorausberechneter Partitionen.
allow_subscription_copy	int	Gibt an, ob die Möglichkeit zum Kopieren der Abonnementdatenbanken aktiviert wurde, die diese Veröffentlichung abonniert haben. Der Wert 0 bedeutet, dass das Kopieren nicht zulässig ist.
allow_synctoalternate	int	Gibt an, ob ein alternativer Synchronisierungspartner für die Synchronisierung mit diesem Verleger zulässig ist. Der Wert 0 bedeutet, dass ein alternativer Synchronisierungspartner nicht zulässig ist.
validate_subscriber_info	nvarchar(500)	Listet die Funktionen auf, die zum Abrufen der Abonnenteninformationen sowie zum Überprüfen der parametrisierten Zeilenfilterkriterien für den Abonnenten verwendet werden. Dies hilft dabei, zu überprüfen, ob die Informationen bei jedem Mergeprozess konsistent partitioniert werden.
backward_comp_level	int	Der Datenbank-Kompatibilitätsgrad. Folgende Werte sind möglich: 10 = SQL Server 7.0 20 = SQL Server 7.0 SP1 30 = SQL Server 7.0 SP2 30 = SQL Server 7.0 SP3 30 = SQL Server 7.0 SP4 40 = SQL Server 2000 40 = SQL Server 2000 SP1 40 = SQL Server 2000 SP2 40 = SQL Server 2000 SP3 90 = SQL Server 2005 90 = SQL Server 2005 SP1 90 = SQL Server 2005 SP2 100 = SQL Server 2008
publish_to_activedirectory	bit	Gibt an, ob die Veröffentlichungsinformationen in Active Directory veröffentlicht werden. Der Wert 0 bedeutet, dass die Veröffentlichungsinformationen nicht in Active Directory verfügbar sind. Dieser Parameter wurde als veraltet markiert und wird nur zum Sicherstellen der Abwärtskompatibilität von Skripts unterstützt. Sie können Active Directory nicht länger Veröffentlichungsinformationen hinzufügen.
max_concurrent_merge	int	Die Anzahl gleichzeitiger Mergeprozesse. Bei 0 gibt es keine Beschränkung für die Anzahl gleichzeitiger Mergeprozesse, die zu einem beliebigen Zeitpunkt ausgeführt werden.
max_concurrent_dynamic_snapshots	int	Die maximale Anzahl gleichzeitiger Sitzungen für eine Momentaufnahme gefilterter Daten, die für die Mergeveröffentlichung ausgeführt werden können. Ist dieser Wert 0, besteht keine Einschränkung für die maximale Anzahl gleichzeitiger Sitzungen für eine Momentaufnahme gefilterter Daten, die für die Veröffentlichung ausgeführt werden können.
use_partition_groups	int	Legt fest, ob vorausberechnete Partitionen verwendet werden. Der Wert 1 bedeutet, dass vorausberechnete Partitionen verwendet werden.
num_of_articles	int	Anzahl der Artikel in der Veröffentlichung.
replicate_ddl	int	Gibt an, ob Schemaänderungen an veröffentlichten Tabellen repliziert werden. Der Wert 1 bedeutet, dass Schemaänderungen repliziert werden.
publication_number	smallint	Die Nummer, die dieser Veröffentlichung zugewiesen ist.
allow_subscriber_initiated_snapshot	bit	Legt fest, ob Abonnenten den Prozess für die Generierung einer Momentaufnahme für gefilterte Daten initiieren können. Der Wert 1 bedeutet, dass Abonnenten den Momentaufnahmeprozess initiieren können.
allow_web_synchronization	bit	Legt fest, ob die Veröffentlichung für die Websynchronisierung aktiviert ist. Der Wert 1 bedeutet, dass die Websynchronisierung aktiviert ist.
web_synchronization_url	nvarchar(500)	Die für die Websynchronisierung verwendete Internet-URL.
allow_partition_realignment	bit	Legt fest, ob Löschvorgänge an den Abonnenten gesendet werden, wenn die Änderung der Zeile auf dem Verleger zum Ändern der Partition führt. Der Wert 1 bedeutet, dass Löschvorgänge an den Abonnenten gesendet werden. Weitere Informationen finden Sie unter sp_addmergepublication (Transact-SQL).
retention_period_unit	tinyint	Definiert die Einheit, die beim Definieren der Beibehaltung verwendet wird. Die folgenden Werte sind möglich: 0 = Tag 1 = Woche 2 = Monat 3 = Jahr
has_downloadonly_articles	bit	Gibt an, ob es sich bei Artikeln, die zur Veröffentlichung gehören, um nur herunterladbare Artikel handelt. Ein Wert von 1 gibt an, dass es sich um nur herunterladbare Artikel handelt.
decentralized_conflicts	int	Gibt an, ob die Konfliktdatensätze auf dem Abonnenten gespeichert werden, der den Konflikt verursacht hat. Ein Wert von 0 gibt an, dass Konfliktdatensätze nicht auf dem Abonnenten gespeichert werden. Ein Wert von 1 gibt an, dass Konfliktdatensätze auf dem Abonnenten gespeichert werden.
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.
automatic_reinitialization_policy	bit	Gibt an, ob Änderungen vom Abonnenten vor einer automatischen erneuten Initialisierung hochgeladen werden. Der Wert 1 gibt an, dass Änderungen vom Abonnenten vor einer automatischen erneuten Initialisierung hochgeladen werden. Der Wert 0 gibt an, dass Änderungen vom Abonnenten vor einer automatischen erneuten Initialisierung nicht hochgeladen werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_helpmergepublication wird für die Mergereplikation verwendet.

Berechtigungen

Mitglieder der Veröffentlichungszugriffsliste für eine Veröffentlichung können sp_helpmergepublication für diese Veröffentlichung ausführen. Mitglieder der festen Datenbankrolle db_owner für die Veröffentlichungsdatenbank können sp_helpmergepublication für Informationen zu allen Veröffentlichungen ausführen.

Beispiel

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks2008R2]
EXEC sp_helpmergepublication @publication = @publication;
GO