sp_helpmergesubscription (Transact-SQL)

Artikel
12/15/2008

Gibt Informationen über ein Abonnement (Push und Pull) für eine Mergepublikation zurück. Diese gespeicherte Prozedur wird auf dem Verleger für die Publikationsdatenbank 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 Publikation. publication ist vom Datentyp sysname, der Standardwert ist %. Die Publikation muss bereits vorhanden sein und den Regeln für Bezeichner entsprechen. Mit NULL oder % werden Informationen zu allen Mergepublikationen und Mergeabonnements in der aktuellen Datenbank zurückgegeben.

[ @subscriber=] 'subscriber'
Der Name des Abonnenten. subscriber ist vom Datentyp sysname und hat den Standardwert %. Mit NULL oder % werden Informationen zu allen Abonnements einer bestimmten Publikation zurückgegeben.

[ @subscriber_db = ] 'subscriber_db'
Der Name der Abonnementdatenbank. subscriber_db ist vom Datentyp sysname und hat den Standardwert %, mit dem Informationen zu allen Abonnementdatenbanken zurückgegeben werden.

[ @publisher = ] 'publisher'
Der Name des Verlegers. Der Verleger muss ein gültiger Server sein. publisher ist vom Datentyp sysname und hat den Standardwert %, mit dem Informationen zu allen Verlegern zurückgegeben werden.

[ @publisher_db =] 'publisher_db'
Der Name der Verlegerdatenbank. publisher_db ist vom Datentyp sysname und hat den Standardwert %, mit dem Informationen zu allen Verlegerdatenbanken zurückgegeben werden.

[ @subscription_type=] 'subscription_type'
Der Abonnementtyp. subscription_type ist 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

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. found ist vom Datentyp int und ein OUTPUT-Parameter mit dem Standardwert NULL. 1 bedeutet, dass die Publikation gefunden wurde. 0 bedeutet, dass die Publikation nicht gefunden wurde.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Spaltenname	Datentyp	Beschreibung
subscription_name	sysname	Name des Abonnements.
publication	sysname	Name der Publikation.
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 Publikation 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.

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 Publikationszugriffsliste für die Publikation, zu der das Abonnement gehört, können sp_helpmergesubscription ausführen.

Siehe auch

Verweis

sp_addmergesubscription (Transact-SQL)
sp_changemergesubscription (Transact-SQL)
sp_dropmergesubscription (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Freigeben über