Delen via

sp_replmonitorhelpsubscription (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Retourneert de huidige statusinformatie voor abonnementen die behoren tot een of meer publicaties in Publisher en retourneert één rij voor elk geretourneerd abonnement. Deze opgeslagen procedure, die wordt gebruikt voor het bewaken van replicatie, wordt uitgevoerd bij de distributeur in de distributiedatabase.

Transact-SQL syntaxis-conventies

Syntaxis

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

Argumenten

[ @publisher = ] N'uitgever'

De naam van de uitgever waarvan de status wordt bewaakt. @publisher is sysname, met een standaardwaarde van NULL. Als er null is, wordt informatie geretourneerd voor alle uitgevers die de distributeur gebruiken.

[ @publisher_db = ] N'publisher_db'

De naam van de gepubliceerde database. @publisher_db is sysname, met een standaardwaarde van NULL. Als NULL, dan wordt informatie geretourneerd voor alle gepubliceerde databases in Publisher.

[ @publication = ] N'publicatie'

De naam van de publicatie die wordt bewaakt. @publication is sysname, met een standaardwaarde van NULL.

[ @publication_type = ] publication_type

Als het type publicatie. @publication_type is int en kan een van deze waarden zijn.

Waarde Beschrijving
0 Transactionele publicatie.
1 Publicatie van momentopname.
2 Publicatie samenvoegen.
NULL (standaard) Replicatie probeert het publicatietype te bepalen.

[ @mode = ] modus

De filtermodus die moet worden gebruikt bij het retourneren van bewakingsgegevens voor abonnementen. @mode is int en kan een van deze waarden zijn.

Waarde Beschrijving
0 (standaard) Retourneert alle abonnementen.
1 Retourneert alleen abonnementen met fouten.
2 Retourneert alleen abonnementen die metrische waarschuwingen voor drempelwaarden genereren.
3 Retourneert alleen abonnementen met fouten of waarschuwingen voor metrische drempelwaarden genereren.
4 Retourneert de 25 ergste abonnementen die het slechtst presteren.
5 Retourneert de 50 ergste abonnementen die het slechtst presteren.
6 Retourneert alleen abonnementen die momenteel worden gesynchroniseerd.
7 Retourneert alleen abonnementen die momenteel niet worden gesynchroniseerd.

[ @topnum = ] topnum

Hiermee beperkt u de resultatenset tot alleen het opgegeven aantal abonnementen boven aan de geretourneerde gegevens. @topnum is int, met een standaardwaarde van NULL.

[ @exclude_anonymous = ] exclude_anonymous

Als anonieme pull-abonnementen worden uitgesloten van de resultatenset. @exclude_anonymous is bit, met een standaardwaarde van 0.

  • Een waarde van 1 dit type betekent dat anonieme abonnementen worden uitgesloten.
  • Een waarde van 0 betekent dat ze zijn opgenomen.

[ @refreshpolicy = ] refreshpolicy

Alleen ter informatie geïdentificeerd. Wordt niet ondersteund. Toekomstige compatibiliteit is niet gegarandeerd.

Resultaatset

Kolomnaam Gegevenstype Beschrijving
status Int Controleert de status van alle replicatieagents die aan de publicatie zijn gekoppeld en retourneert de hoogste status die in de volgende volgorde wordt gevonden:

6 = Mislukt
5 = Opnieuw proberen
2 = Gestopt
4 = Niet-actief
3 = Wordt uitgevoerd
1 = Gestart
warning Int Waarschuwing voor maximale drempelwaarde die wordt gegenereerd door een abonnement dat deel uitmaakt van de publicatie. Dit kan het logische of resultaat zijn van een of meer van deze waarden.

1 = expiration - Een abonnement op een transactionele publicatie is niet gesynchroniseerd binnen de drempelwaarde voor de bewaarperiode.
2 = latency - de tijd die nodig is om gegevens van een transactionele uitgever naar de abonnee te repliceren, overschrijdt de drempelwaarde in seconden.
4 = mergeexpiration - Een abonnement op een samenvoegpublicatie is niet gesynchroniseerd binnen de drempelwaarde voor de bewaarperiode.
8 = mergefastrunduration - de tijd die nodig is om de synchronisatie van een samenvoegabonnement te voltooien, overschrijdt de drempelwaarde, in seconden, via een snelle netwerkverbinding.
16 = mergeslowrunduration - de tijd die nodig is om de synchronisatie van een samenvoegabonnement te voltooien, overschrijdt de drempelwaarde, in seconden, via een trage netwerkverbinding.
32 = mergefastrunspeed - de leveringssnelheid voor rijen tijdens de synchronisatie van een samenvoegabonnement kan de drempelwaarde, in rijen per seconde, niet behouden via een snelle netwerkverbinding.
64 = mergeslowrunspeed - de leveringssnelheid voor rijen tijdens de synchronisatie van een samenvoegabonnement kan de drempelwaarde, in rijen per seconde, niet behouden via een trage netwerkverbinding.
subscriber sysname De naam van de abonnee.
subscriber_db sysname De naam van de database die wordt gebruikt voor het abonnement.
publisher_db sysname De naam van de publicatiedatabase.
publication sysname De naam van een publicatie.
publication_type Int Het type publicatie, dat een van deze waarden kan zijn:

0 = Transactionele publicatie
1 = Publicatie van momentopname
2 = Publicatie samenvoegen
subtype Int Het abonnementstype, dat een van de volgende waarden kan zijn:

0 = Push
1 = Pull
2 = Anoniem
latency Int De hoogste latentie, in seconden, voor gegevenswijzigingen die worden doorgegeven door de logboeklezer of distributieagenten voor een transactionele publicatie.
latencythreshold Int De maximale latentie voor de transactionele publicatie, waarboven een waarschuwing wordt gegenereerd.
agentnotrunning Int De tijdsduur, in uren, waarin de agent niet is uitgevoerd.
agentnotrunningthreshold Int De tijdsduur, in uren, die de agent niet heeft uitgevoerd voordat er een waarschuwing wordt gegenereerd.
timetoexpiration Int De tijdsduur, in uren, voordat het abonnement verloopt, indien niet gesynchroniseerd.
expirationthreshold Int De tijd, in uren, voordat het abonnement verloopt dat er een waarschuwing wordt gegenereerd.
last_distsync datum en tijd De datum/tijd waarop de distributieagent het laatst is uitgevoerd.
distribution_agentname sysname De naam van de distributieagenttaak voor het abonnement op een transactionele publicatie.
mergeagentname sysname De naam van de samenvoegagenttaak voor het abonnement naar een samenvoegpublicatie.
mergesubscriptionfriendlyname sysname De beschrijvende naam die aan het abonnement is gegeven.
mergeagentlocation sysname De naam van de server waarop de samenvoegagent wordt uitgevoerd.
mergeconnectiontype Int Verbinding die wordt gebruikt bij het synchroniseren van een abonnement op een samenvoegpublicatie, wat een van de volgende waarden kan zijn:

1 = Local Area Network (LAN)
2 = inbelnetwerkverbinding
3 = Websynchronisatie.
mergePerformance Int Prestaties van de laatste synchronisatie vergeleken met alle synchronisaties voor het abonnement, die is gebaseerd op de leveringssnelheid van de laatste synchronisatie gedeeld door het gemiddelde van alle eerdere leveringstarieven.
mergerunspeed drijven Het leveringspercentage van de laatste synchronisatie voor het abonnement.
mergerunduration Int De tijdsduur voor het voltooien van de laatste synchronisatie van het abonnement.
monitorranking Int De classificatiewaarde die wordt gebruikt om de abonnementen in de resultatenset te orden en kan een van deze waarden zijn:

Voor een transactionele publicatie:

60 = Fout
56 = Waarschuwing: prestatiekritiek
52 = Waarschuwing: binnenkort verlopen of verlopen
50 = Waarschuwing: abonnement niet geïnitialiseerd
40 = Mislukte opdracht opnieuw proberen
30 = Niet actief (geslaagd)
20 = Wordt uitgevoerd (starten, uitvoeren of niet-actief)

Voor een samenvoegpublicatie:

60 = Fout
56 = Waarschuwing: prestatiekritiek
54 = Waarschuwing: langdurige samenvoeging
52 = Waarschuwing: binnenkort verlopen
50 = Waarschuwing: abonnement niet geïnitialiseerd
40 = Mislukte opdracht opnieuw proberen
30 = Wordt uitgevoerd (starten, uitvoeren of niet-actief)
20 = Niet actief (geslaagd)
distributionagentjobid binary(16) Id van de distributieagenttaak voor abonnementen op een transactionele publicatie.
mergeagentjobid binary(16) Id van de samenvoegagenttaak voor abonnementen op een samenvoegpublicatie.
distributionagentid Int Id van de distributieagenttaak voor het abonnement.
distributionagentprofileid Int Id van het agentprofiel dat wordt gebruikt door de distributieagent.
mergeagentid Int Id van de samenvoegagenttaak voor het abonnement.
mergeagentprofileid Int Id van het agentprofiel dat wordt gebruikt door de samenvoegagent.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Opmerkingen

sp_replmonitorhelpsubscription wordt gebruikt met alle typen replicatie.

sp_replmonitorhelpsubscription geeft de resultatenset op basis van de ernst van de status van het abonnement, die wordt bepaald door de waarde van monitorranking. Rijen voor alle abonnementen met een foutstatus worden bijvoorbeeld geordend boven rijen voor abonnementen met een waarschuwingsstatus.

Machtigingen

Alleen leden van de db_owner of replmonitor vaste databaserol in de distributiedatabase kunnen worden uitgevoerd sp_replmonitorhelpsubscription.

Verwante inhoud