sp_helpmergesubscription (Transact-SQL)

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 und hat den Standardwert %. Mit NULL oder % werden Informationen zu allen Abonnements einer bestimmten Veröffentlichung 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

  • [ @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 Veröffentlichung gefunden wurde. 0 bedeutet, dass die Veröffentlichung nicht gefunden wurde.

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.