sp_helpmergesubscription (Transact-SQL)

  • Artikel

Gilt für:SQL Server

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.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @publication = ] N'Publikation'

Der Name der Veröffentlichung. @publication ist "sysname" mit der Standardeinstellung "%. Die Publikation muss bereits vorhanden sein und den Regeln für Bezeichner entsprechen. Wenn NULL oder %, Werden Informationen zu allen Zusammenführungspublikationen und Abonnements in der aktuellen Datenbank zurückgegeben.

[ @subscriber = ] N'subscriber'

Den Namen des Abonnenten. @subscriber ist "sysname" mit der Standardeinstellung "%. Wenn NULL oder %, Werden Informationen zu allen Abonnements der angegebenen Publikation zurückgegeben.

[ @subscriber_db = ] N'subscriber_db'

Der Name der Abonnementdatenbank. @subscriber_db ist "sysname" mit dem Standardwert "%, der Informationen zu allen Abonnementdatenbanken zurückgibt.

[ @publisher = ] N'publisher'

Der Name des Herausgebers. @publisher ist "sysname" mit dem Standardwert "%, mit einem Standardwert von %, der Informationen zu allen Herausgebern zurückgibt. Der Verleger muss ein gültiger Server sein.

[ @publisher_db = ] N'publisher_db'

Der Name der Verlegerdatenbank. @publisher_db ist "sysname" mit dem Standardwert %", der Informationen zu allen Publisher-Datenbanken zurückgibt.

[ @subscription_type = ] N'subscription_type'

Der Abonnementtyp. @subscription_type ist nvarchar(15) und kann einer dieser Werte sein.

Wert Beschreibung
push (Standardwert) Pushabonnement
pull Pullabonnement
both Sowohl ein Push- als auch ein Pullabonnement

[ @found = ] ausgabe gefunden

Ein Kennzeichen, das angibt, dass Zeilen zurückgegeben werden. @found ist ein OUTPUT-Parameter vom Typ int.

  • 1 gibt an, dass die Publikation gefunden wird.
  • 0 gibt an, dass die Publikation nicht gefunden wurde.

Resultset

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 warten auf den Start

1 = Mindestens ein Aufträge wird gestartet.

2 = Alle Aufträge wurden erfolgreich ausgeführt

3 = Mindestens ein Auftrag wird ausgeführt

4 = Alle Aufträge sind geplant und im Leerlauf

5 = Mindestens ein Auftrag versucht, nach einem vorherigen Fehler auszuführen

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 = Beides
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. Wenn NULL, wird die Ausführung bei Publisher ausgeführt.
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. Wenn 0der interaktive Resolver nicht verwendet wird.
hostname sysname Der Wert, der angegeben wird, wenn ein Abonnement nach dem Wert der funktion HOST_NAME gefiltert wird.
subscriber_security_mode smallint Der Sicherheitsmodus am Abonnenten, wo 1 bedeutet Windows-Authentifizierung und 0 bedeutet SQL Server-Authentifizierung.
subscriber_login sysname Der Anmeldename beim Abonnenten.
subscriber_password sysname Das tatsächliche Abonnentenkennwort wird nie zurückgegeben. Das Ergebnis wird durch eine ****** Zeichenfolge maskiert.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Hinweise

sp_helpmergesubscription wird in der Seriendruckreplikation verwendet, um Abonnementinformationen zurückzugeben, die im Publisher gespeichert sind, oder um abonnenten erneut zu veröffentlichen.

Bei anonymen Abonnements ist der subscription_typeWert immer 1 (Pull). Sie müssen jedoch sp_helpmergepullsubscription beim Abonnenten ausführen, um Informationen zu anonymen Abonnements zu erfahren.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin , der db_owner festen Datenbankrolle oder die Publikationszugriffsliste für die Publikation, zu der das Abonnement gehört, kann ausgeführt werden sp_helpmergesubscription.

Zugehöriger Inhalt