sp_helpmergesubscription (Transact-SQL)
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 Start1 = Mindestens ein Aufträge wird gestartet.2 = Alle Aufträge wurden erfolgreich ausgeführt3 = Mindestens ein Auftrag wird ausgeführt4 = Alle Aufträge sind geplant und im Leerlauf5 = Mindestens ein Auftrag versucht, nach einem vorherigen Fehler auszuführen6 = Mindestens ein Auftrag konnte nicht erfolgreich ausgeführt werden. |
subscriber_type |
int | Abonnententyp |
subscription_type |
int | Typ des Abonnements:0 = Push1 = Pull2 = 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 0 der 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
(erfolgreich) 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
.