sp_replmonitorhelpsubscription (Transact-SQL)

Gibt die aktuellen Statusinformationen für Abonnements zurück, die zu einer oder mehreren Veröffentlichungen auf dem Verleger gehören. Dabei wird eine Zeile für jedes zurückgegebene Abonnement zurückgegeben. Diese gespeicherte Prozedur dient zur Überwachung der Replikation und wird auf dem Verteiler für die Verteilungsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_replmonitorhelpsubscription [ @publisher = ] 'publisher'
    [ , [ @publisher_db = ] 'publisher_db' ]
    [ , [ @publication = ] 'publication' ]
    [ , [ @publication_type = ] publication_type ] 
    [ , [ @mode = ] mode ]
    [ , [ @topnum = ] topnum ] 
    [ , [ @exclude_anonymous = ] exclude_anonymous ] 
    [ , [ @refreshpolicy = ] refreshpolicy ]

Argumente

• [ @publisher= ] 'publisher'
  Der Name des Verlegers, dessen Status überwacht wird. publisher ist vom Datentyp sysname und hat den Standardwert NULL. Lautet der Wert null, werden Informationen für alle Verleger zurückgegeben, die diesen Verteiler verwenden.

• [ @publisher_db = ] 'publisher_db'
  Der Name der veröffentlichten Datenbank. publisher_db ist vom Datentyp sysname und hat den Standardwert NULL. Lautet der Wert NULL, werden Informationen für alle veröffentlichten Datenbanken auf dem Verleger zurückgegeben.

• [ @publication= ] 'publication'
  Der Name der überwachten Veröffentlichung. publication ist vom Datentyp sysname und hat den Standardwert NULL.

• [ @publication_type= ] publication_type
  Der Typ der Veröffentlichung. publication_type ist vom Datentyp int. Die folgenden Werte sind möglich:

  Wert	Beschreibung
  0	Transaktionsveröffentlichung.
  1	Snapshotveröffentlichung.
  2	Mergeveröffentlichung.
  NULL (Standard)	Die Replikation versucht, den Veröffentlichungstyp zu bestimmen.

• [ @mode = ] mode
  Der beim Zurückgeben von Informationen zur Abonnementüberwachung zu verwendende Filtermodus. mode ist vom Datentyp int. Die folgenden Werte sind möglich:

  Wert	Beschreibung
  0 (Standardwert)	Gibt alle Abonnements zurück.
  1	Gibt nur Abonnements mit Fehlern zurück.
  2	Gibt nur Abonnements zurück, die Schwellenwertwarnungen generiert haben.
  3	Gibt nur Abonnements zurück, die entweder Fehler aufweisen oder Schwellenwertwarnungen generiert haben.
  4	Gibt die 25 Abonnements zurück, die die schlechteste Leistung aufweisen.
  5	Gibt die 50 Abonnements zurück, die die schlechteste Leistung aufweisen.
  6	Gibt nur Abonnements zurück, für die zurzeit eine Synchronisierung im Gange ist.
  7	Gibt nur Abonnements zurück, für die zurzeit keine Synchronisierung im Gange ist.

• [ @topnum = ] topnum
  Schränkt das Resultset auf die angegebene Anzahl von Abonnements ab dem Anfang der zurückgegebenen Daten ein. topnum ist vom Datentyp int und hat keinen Standardwert.

• [ @exclude_anonymous = ] exclude_anonymous
  Gibt an, ob anonyme Pullabonnements aus dem Resultset ausgeschlossen werden. exclude_anonymous ist vom Datentyp bit und hat den Standardwert 0. Der Wert 1 bedeutet, dass anonyme Abonnements ausgeschlossen werden, und der Wert 0 bedeutet, dass sie im Resultset eingeschlossen werden.

• [ @refreshpolicy= ] refreshpolicy
  Nur interne Verwendung.

Resultsets

Spaltenname	Datentyp	Beschreibung
status	int	Informationen zum maximalen Statuscode unter allen Replikations-Agents, die der Veröffentlichung zugewiesen sind. Dies kann einer der folgenden Werte sein: 1 = Gestartet 2 = Erfolgreich beendet 3 = Vorgang wird ausgeführt 4 = Im Leerlauf 5 = Wird wiederholt 6 = Fehler
warning	int	Die Schwellenwertwarnung mit dem höchsten Code, die von einem der Veröffentlichung zugehörigen Abonnement generiert wird. Dies kann das logische OR eines oder mehrerer der folgenden Werte sein. 1 = expiration - ein Abonnement auf eine Transaktionsveröffentlichung wurde nicht innerhalb des Schwellenwerts für die Beibehaltungsdauer synchronisiert. 2 = latency - die zur Replikation von Daten aus einem Transaktionsverleger auf den Abonnenten in Anspruch genommene Zeit (in Sekunden) übersteigt den Schwellenwert. 4 = mergeexpiration - ein Abonnement auf eine Mergeveröffentlichung wurde nicht innerhalb des Schwellenwerts für die Beibehaltungsdauer synchronisiert. 8 = mergefastrunduration - die zum Abschließen der Synchronisierung eines Mergeabonnements in Anspruch genommene Zeit (in Sekunden) überschreitet den Schwellenwert bei einer schnellen Netzwerkverbindung. 16 = mergeslowrunduration - die zum Abschließen der Synchronisierung eines Mergeabonnements in Anspruch genommene Zeit (in Sekunden) überschreitet den Schwellenwert bei einer langsamen oder einer DFÜ-Netzwerkverbindung. 32 = mergefastrunspeed - die Zeilenübermittlungsrate bei der Synchronisierung eines Mergeabonnements über eine schnelle Netzwerkverbindung konnte den Schwellenwert (in Zeilen pro Sekunde) nicht einhalten. 64 = mergeslowrunspeed - die Zeilenübermittlungsrate bei der Synchronisierung eines Mergeabonnements über eine langsame Netzwerkverbindung oder eine DFÜ-Netzwerkverbindung konnte den Schwellenwert (in Zeilen pro Sekunde) nicht einhalten.
subscriber	sysname	Der Name des Abonnenten.
subscriber_db	sysname	Der Name der für das Abonnement verwendeten Datenbank.
publisher_db	sysname	Der Name der Veröffentlichungsdatenbank.
publication	sysname	Der Name der Veröffentlichung.
publication_type	int	Der Veröffentlichungstyp, der einen der folgenden Werte haben kann: 0 = Transaktionsveröffentlichung 1 = Snapshotveröffentlichung 2 = Mergeveröffentlichung
subtype	int	Der Abonnementtyp, der einen der folgenden Werte haben kann: 0 = Push 1 = Pull 2 = Anonym
latency	int	Die höchste Latenzzeit (in Sekunden) für Datenänderungen, die vom Protokollleser oder vom Verteilungs-Agent für eine Transaktionsveröffentlichung weitergegeben werden.
latencythreshold	int	Die maximale Latenzzeit für die Transaktionsveröffentlichung, bei deren Überschreiten eine Warnung ausgegeben wird.
agentnotrunning	int	Der Zeitraum (in Stunden), während dessen der Agent nicht ausgeführt wird.
agentnotrunningthreshold	int	Der Zeitraum (in Stunden), während dessen der Agent nicht ausgeführt und bei dessen Erreichen eine Warnung ausgegeben wird.
timetoexpiration	int	Der Zeitraum (in Stunden), an dessen Ende ein Abonnement abläuft, falls es nicht synchronisiert wird.
expirationthreshold	int	Die Zeit (in Stunden) vor dem Ablaufen eines Abonnements, zu der eine entsprechende Warnmeldung ausgegeben wird.
last_distsync	datetime	Der datetime-Wert der letzten Ausführung des Verteilungs-Agents.
distribution_agentname	sysname	Der Name des Verteilungs-Agent-Auftrags für das Abonnement auf eine Transaktionsveröffentlichung.
mergeagentname	sysname	Der Name des Merge-Agent-Auftrags für das Abonnement auf eine Mergeveröffentlichung.
mergesubscriptionfriendlyname	sysname	Der für das Abonnement angegebene angezeigte Name.
mergeagentlocation	sysname	Der Name des Servers, auf dem der Merge-Agent ausgeführt wird.
mergeconnectiontype	int	Die beim Synchronisieren eines Abonnements auf eine Mergeveröffentlichung verwendete Verbindung, die einen der folgenden Werte haben kann: 1 = lokales Netzwerk (Local Area Network, LAN) 2 = DFÜ-Netzwerkverbindung 3 = Websynchronisierung.
mergePerformance	int	Die Leistung der letzten Synchronisierung im Vergleich zu allen Synchronisierungen des Abonnements. Sie ergibt sich aus der Übermittlungsrate der letzten Synchronisierung dividiert durch den Durchschnitt aller vorhergegangenen Übermittlungsraten.
mergerunspeed	float	Die Übermittlungsrate der letzten Synchronisierung des Abonnements.
mergerunduration	int	Der Zeitraum für den Abschluss der letzten Synchronisierung des Abonnements.
monitorranking	int	Der Rangfolgenwert, der zur Sortierung der Abonnements im Resultset verwendet wird. Er kann folgende Werte haben: Für eine Transaktionsveröffentlichung: 60 = Fehler 56 = Warnung: Leistung im kritischen Bereich 52 = Warnung: Läuft demnächst ab oder Abgelaufen 50 = Warnung: Abonnement nicht initialisiert 40 = fehlerhafter Befehl wird wiederholt 30 = Wird nicht ausgeführt (Erfolg) 20 = Wird ausgeführt (wird gestartet, wird ausgeführt oder im Leerlauf) Für eine Mergeveröffentlichung: 60 = Fehler 56 = Warnung: Leistung im kritischen Bereich 54 = Warnung: Langer Mergevorgang 52 = Warnung: Läuft demnächst ab 50 = Warnung: Abonnement nicht initialisiert 40 = fehlerhafter Befehl wird wiederholt 30 = Wird ausgeführt (wird gestartet, wird ausgeführt oder im Leerlauf) 20 = Wird nicht ausgeführt (Erfolg)
distributionagentjobid	binary(16)	ID des Verteilungs-Agent-Auftrags für Abonnements auf eine Transaktionsveröffentlichung.
mergeagentjobid	binary(16)	ID des Merge-Agent-Auftrags für Abonnements auf eine Mergeveröffentlichung.
distributionagentid	int	ID des Verteilungs-Agent-Auftrags für das Abonnement.
distributionagentprofileid	int	ID des vom Verteilungs-Agent verwendeten Agentprofils.
mergeagentid	int	ID des Merge-Agent-Auftrags für das Abonnement.
mergeagentprofileid	int	ID des vom Merge-Agent verwendeten Agentprofils.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_replmonitorhelpsubscription wird für alle Replikationstypen verwendet.

sp_replmonitorhelpsubscription sortiert das Resultset nach dem Schweregrad des Abonnementstatus, der vom Wert für monitorranking bestimmt wird. So werden z. B. Zeilen für alle Abonnements, die einen Fehlerzustand aufweisen, oberhalb der Zeilen für Abonnements einsortiert, die einen Warnungsstatus aufweisen.

Berechtigungen

Nur Mitglieder der festen Datenbankrolle db_owner oder replmonitor in der Verteilungsdatenbank können sp_replmonitorhelpsubscription ausführen.

Siehe auch

Aufgaben

Vorgehensweise: Programmgesteuertes Überwachen der Replikation (Replikationsprogrammierung mit Transact-SQL)