Freigeben über


sp_helpmergepublication (Transact-SQL)

Gibt Informationen zu einer Mergeveröffentlichung zurück. Diese gespeicherte Prozedur wird auf Verlegerebene für die 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'
    Entspricht dem Namen der Veröffentlichung. publicationist vom Datentyp sysname. Der Standardwert ist %, 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. Der Standardwert ist NULL. 1 zeigt an, dass die Veröffentlichung gefunden wurde. 0 zeigt an, dass die Veröffentlichung nicht gefunden wurde.

  • [ @publication\_id**=**\] **'**publication_id' OUTPUT
    Die Veröffentlichung-ID. publication_id ist vom Datentyp uniqueidentifier und ein OUTPUT-Parameter. Der Standardwert ist 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 vom Datentyp sysname. Der Standardwert ist NULL.

  • [@publisher_db**=** ] 'publisher_db'
    Der Name der Veröffentlichungsdatenbank. publisher_db ist vom Datentyp sysname. Der Standardwert ist 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 zugelassen wird.

allow_pull

int

Bestimmt, ob für die angegebene Veröffentlichung Pullabonnements erstellt werden können. 0 bedeutet, dass ein Pullabonnement nicht zugelassen wird.

allow_anonymous

int

Bestimmt, ob für die angegebene Veröffentlichung anonyme Abonnements erstellt werden können. 0 bedeutet, dass ein anonymes Abonnement nicht zugelassen wird.

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 ein parametrisierter Zeilenfilter nicht verwendet wird.

has_subscription

bit

Gibt an, ob die Veröffentlichung über Abonnements verfügt. 0 bedeutet, dass für diese Veröffentlichung derzeit keine Abonnements 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.

HinweisHinweis

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, der 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öffentlichungsmomentaufnahmedateien 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öffentlichungsmomentaufnahmedateien zum Abholen durch den Merge-Agent gespeichert sind.

ftp_subdirectory

nvarchar(255)

Gibt an, wo die Veröffentlichungsmomentaufnahmedateien 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 mit dem 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 die Synchronisierungsoptimierung für diese Veröffentlichung 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.

HinweisHinweis

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:

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 eine 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.

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 Neuinitialisierung nicht hochgeladen werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_helpmergepublication wird bei der 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 [AdventureWorks2012]
EXEC sp_helpmergepublication @publication = @publication;
GO

Siehe auch

Verweis

sp_addmergepublication (Transact-SQL)

sp_changemergepublication (Transact-SQL)

sp_dropmergepublication (Transact-SQL)

Gespeicherte Replikationsprozeduren (Transact-SQL)

Konzepte

Anzeigen und Ändern von Veröffentlichungseigenschaften