sp_helpmergesubscription (Transact-SQL)

Artikel
05/07/2013

Gibt Informationen über ein Abonnement (Push und Pull) für eine Mergeveröffentlichung zurück. Diese gespeicherte Prozedur wird auf dem Verleger für die Veröffentlichungsdatenbank oder auf dem Wiederveröffentlichungsabonnenten für die Abonnementdatenbank ausgeführt.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

sp_helpmergesubscription [ [ @publication=] 'publication']
    [ , [ @subscriber=] 'subscriber']
    [ , [ @subscriber_db=] 'subscriber_db']
    [ , [ @publisher=] 'publisher']
    [ , [ @publisher_db=] 'publisher_db']
    [ , [ @subscription_type=] 'subscription_type']
    [ , [ @found=] 'found' OUTPUT]

Argumente

[ @publication=] 'publication'
Der Name der Veröffentlichung. publication ist vom Datentyp sysname. Der Standardwert ist %. Die Veröffentlichung muss bereits vorhanden sein und den Regeln für Bezeichner entsprechen. Mit NULL oder % werden Informationen zu allen Mergeveröffentlichungen und Mergeabonnements in der aktuellen Datenbank zurückgegeben.
[ @subscriber=] 'subscriber'
Der Name des Abonnenten. subscriber ist vom Datentyp sysname. Der Standardwert ist %. Mit NULL oder % werden Informationen zu allen Abonnements einer bestimmten Veröffentlichung zurückgegeben.
[ @subscriber_db=] 'subscriber_db'
Der Name der Abonnementdatenbank. subscriber_dbist vom Datentyp sysname. Mit dem Standardwert % werden Informationen über alle Abonnementdatenbanken zurückgegeben.
[ @publisher=] 'publisher'
Der Name des Verlegers. Der Verleger muss ein gültiger Server sein. publisherist vom Datentyp sysname. Mit dem Standardwert % werden Informationen über alle Verleger zurückgegeben.
[ @publisher_db=] 'publisher_db'
Der Name der Verlegerdatenbank. publisher_dbist vom Datentyp sysname. Mit dem Standardwert % werden Informationen über alle Verlegerdatenbanken zurückgegeben.
[ @subscription_type=] 'subscription_type'
Der Typ des Abonnements. subscription_typeist vom Datentyp nvarchar(15). Die folgenden Werte sind möglich:

Wert

Beschreibung

push (Standard)

Pushabonnement

Pull

Pullabonnement

both

Sowohl ein Push- als auch ein Pullabonnement
[ @found=] 'found'OUTPUT
Ein Flag zur Angabe zurückgegebener Zeilen. foundist vom Datentyp int und ein OUTPUT-Parameter. Der Standardwert ist NULL. 1 bedeutet, dass die Veröffentlichung gefunden wurde. 0 gibt an, dass die Veröffentlichung nicht gefunden wurde.

Wert	Beschreibung
push (Standard)	Pushabonnement
Pull	Pullabonnement
both	Sowohl ein Push- als auch ein Pullabonnement

Resultsets

Spaltenname	Datentyp	Beschreibung
subscription_name	sysname	Name des Abonnements.
publication	sysname	Name der Veröffentlichung.
publisher	sysname	Name des Verlegers.
publisher_db	sysname	Name der Verlegerdatenbank.
subscriber	sysname	Name des Abonnenten.
subscriber_db	sysname	Name der Abonnementdatenbank.
status	int	Status des Abonnements: 0 = Alle Aufträge sind für den Start bereit. 1 = Ein oder mehrere Aufträge werden gestartet. 2 = Alle Aufträge wurden erfolgreich ausgeführt. 3 = Mindestens ein Auftrag wird ausgeführt. 4 = Alle Aufträge sind geplant und befinden sich im Leerlauf. 5 = Mindestens ein Auftrag soll ausgeführt werden, der zuvor bereits einen Fehler erzeugt hat. 6 = Mindestens ein Auftrag konnte nicht erfolgreich ausgeführt werden.
subscriber_type	int	Abonnententyp
subscription_type	int	Typ des Abonnements: 0 = Push 1 = Pull 2 = Beide
priority	float(8)	Zahl zur Angabe der Priorität für das Abonnement.
sync_type	tinyint	Synchronisierungsart des Abonnements.
description	nvarchar(255)	Kurze Beschreibung des Mergeabonnements.
merge_jobid	binary(16)	Auftrags-ID des Merge-Agents.
full_publication	tinyint	Gibt an, ob das Abonnement für eine vollständige oder gefilterte Veröffentlichung besteht.
offload_enabled	bit	Gibt an, ob festgelegt wurde, dass die Auslagerungsausführung eines Replikations-Agents auf dem Abonnenten ausgeführt wird. Bei NULL erfolgt die Ausführung auf dem Verleger.
offload_server	sysname	Name des Servers, auf den der Agent verlagert wird.
use_interactive_resolver	int	Gibt zurück, ob der interaktive Konfliktlöser während der Konfliktlösung verwendet wird. Bei 0 wird der interaktive Konfliktlöser nicht verwendet.
hostname	sysname	Der Wert, der bereitgestellt wird, wenn ein Abonnement durch den Wert der HOST_NAME-Funktion gefiltert wird.
subscriber_security_mode	smallint	Der Sicherheitsmodus auf dem Abonnenten, wobei 1 die Windows-Authentifizierung und 0 die Microsoft SQL Server-Authentifizierung angibt.
subscriber_login	sysname	Der Anmeldename auf dem Abonnenten.
subscriber_password	sysname	Das eigentliche Abonnentenkennwort, das nie zurückgegeben wird. Das Ergebnis wird durch die Zeichenfolge "******" maskiert.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_helpmergesubscription wird in der Mergereplikation zur Rückgabe von Abonnementinformationen verwendet, die auf dem Verleger oder dem Wiederveröffentlichungsabonnenten gespeichert sind.

Bei anonymen Abonnements weist subscription_type stets den Wert 1 (Pull) auf. Sie müssen jedoch sp_helpmergepullsubscription auf dem Abonnenten ausführen, um Informationen zu anonymen Abonnements zu erhalten.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin, der festen Datenbankrolle db_owner oder der Veröffentlichungszugriffsliste für die Veröffentlichung, zu der das Abonnement gehört, können sp_helpmergesubscription ausführen.