Dela via

sp_replmonitorhelpsubscription (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Returnerar aktuell statusinformation för prenumerationer som tillhör en eller flera publikationer på Publisher och returnerar en rad för varje returnerad prenumeration. Den här lagrade proceduren, som används för att övervaka replikering, körs hos distributören i distributionsdatabasen.

Transact-SQL syntaxkonventioner

Syntax

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 ]
[ ; ]

Argumentpunkter

[ @publisher = ] N'utgivare'

Namnet på utgivaren vars status övervakas. @publisher är sysname, med standardvärdet NULL. Om värdet är null returneras information för alla utgivare som använder distributören.

[ @publisher_db = ] N'publisher_db'

Namnet på den publicerade databasen. @publisher_db är sysname med standardvärdet NULL. Om NULLreturneras information för alla publicerade databaser i Publisher.

[ @publication = ] N'publication'

Namnet på publikationen som övervakas. @publication är sysname, med standardvärdet NULL.

[ @publication_type = ] publication_type

Om typen av publikation. @publication_type är int och kan vara ett av dessa värden.

Värde Beskrivning
0 Transaktionspublicering.
1 Publikation för ögonblicksbilder.
2 Koppla publikationen.
NULL (standardinställning) Replikeringen försöker fastställa publikationstypen.

[ @mode = ] läge

Det filtreringsläge som ska användas när du returnerar information om prenumerationsövervakning. @mode är int och kan vara ett av dessa värden.

Värde Beskrivning
0 (standardinställning) Returnerar alla prenumerationer.
1 Returnerar endast prenumerationer med fel.
2 Returnerar endast prenumerationer som genererar tröskelvärdesvarningar.
3 Returnerar endast prenumerationer som antingen har fel eller genererar tröskelvärdesvarningar.
4 Returnerar de 25 mest högpresterande prenumerationerna.
5 Returnerar de 50 mest högpresterande prenumerationerna.
6 Returnerar endast prenumerationer som för närvarande synkroniseras.
7 Returnerar endast prenumerationer som för närvarande inte synkroniseras.

[ @topnum = ] topnum

Begränsar resultatuppsättningen till endast det angivna antalet prenumerationer överst i de returnerade data. @topnum är int, med standardvärdet NULL.

[ @exclude_anonymous = ] exclude_anonymous

Om anonyma pull-prenumerationer undantas från resultatuppsättningen. @exclude_anonymous är bit, med standardvärdet 0.

  • Värdet 1 innebär att anonyma prenumerationer undantas.
  • 0 Värdet innebär att de ingår.

[ @refreshpolicy = ] refreshpolicy

Identifieras endast i informationssyfte. Stöds inte. Framtida kompatibilitet garanteras inte.

Resultatuppsättning

Kolumnnamn Datatyp Beskrivning
status Int Undersöker statusen för alla replikeringsagenter som är associerade med publikationen och returnerar den högsta statusen som finns i följande ordning:

6 = Misslyckades
5 = Försök igen
2 = Stoppad
4 = Inaktiv
3 = Pågår
1 = Startad
warning Int Högsta tröskelvärdesvarning som genereras av en prenumeration som tillhör publikationen, vilket kan vara det logiska ELLER resultatet av ett eller flera av dessa värden.

1 = expiration – en prenumeration på en transaktionspublikation har inte synkroniserats inom tröskelvärdet för kvarhållningsperiod.
2 = latency – den tid det tar att replikera data från en transaktionsutgivare till prenumeranten överskrider tröskelvärdet i sekunder.
4 = mergeexpiration – en prenumeration på en sammanslagningspublikation har inte synkroniserats inom tröskelvärdet för kvarhållningsperiod.
8 = mergefastrunduration – Den tid det tar att slutföra synkroniseringen av en sammanslagningsprenumeration överskrider tröskelvärdet, i sekunder, över en snabb nätverksanslutning.
16 = mergeslowrunduration – den tid det tar att slutföra synkroniseringen av en sammanslagningsprenumeration överskrider tröskelvärdet, i sekunder, över en långsam nätverksanslutning.
32 = mergefastrunspeed – Leveransfrekvensen för rader under synkroniseringen av en sammanslagningsprenumeration kunde inte upprätthålla tröskelvärdet, i rader per sekund, över en snabb nätverksanslutning.
64 = mergeslowrunspeed – Leveransfrekvensen för rader under synkroniseringen av en sammanslagningsprenumeration kunde inte upprätthålla tröskelvärdet, i rader per sekund, över en långsam nätverksanslutning.
subscriber sysname Namnet på prenumeranten.
subscriber_db sysname Namnet på databasen som används för prenumerationen.
publisher_db sysname Namnet på publikationsdatabasen.
publication sysname Namnet på en publikation.
publication_type Int Typen av publikation, som kan vara ett av följande värden:

0 = Transaktionspublicering
1 = Publikation för ögonblicksbilder
2 = Sammanfoga publikation
subtype Int Prenumerationstypen, som kan vara något av följande värden:

0 = Push
1 = Pull
2 = Anonym
latency Int Den högsta svarstiden, i sekunder, för dataändringar som sprids av loggläsaren eller distributionsagenterna för en transaktionspublikation.
latencythreshold Int Den maximala svarstiden för transaktionspublikationen, över vilken en varning utlöses.
agentnotrunning Int Hur lång tid, i timmar, under vilken agenten inte har körts.
agentnotrunningthreshold Int Hur lång tid, i timmar, som agenten inte har kört innan en varning utlöses.
timetoexpiration Int Hur lång tid, i timmar, innan prenumerationen upphör att gälla om den inte synkroniseras.
expirationthreshold Int Tiden, i timmar, innan prenumerationen upphör att gälla som en varning utlöses.
last_distsync datetime Den datetime som distributionsagenten senast körde.
distribution_agentname sysname Namnet på distributionsagentjobbet för prenumerationen på en transaktionspublikation.
mergeagentname sysname Namnet på jobbet Merge Agent för prenumerationen på en sammanslagningspublikation.
mergesubscriptionfriendlyname sysname Det egna namnet som ges till prenumerationen.
mergeagentlocation sysname Namnet på den server där sammanslagningsagenten körs.
mergeconnectiontype Int Anslutning som används vid synkronisering av en prenumeration till en sammanslagningspublikation, vilket kan vara något av följande värden:

1 = lokalt nätverk (LAN)
2 = uppringningsnätverksanslutning
3 = Webbsynkronisering.
mergePerformance Int Prestanda för den senaste synkroniseringen jämfört med alla synkroniseringar för prenumerationen, som baseras på leveransfrekvensen för den senaste synkroniseringen dividerat med genomsnittet av alla tidigare leveranspriser.
mergerunspeed sväva Leveransfrekvensen för den senaste synkroniseringen för prenumerationen.
mergerunduration Int Hur lång tid det tar att slutföra den senaste synkroniseringen av prenumerationen.
monitorranking Int Det rangordningsvärde som används för att beställa prenumerationerna i resultatuppsättningen och kan vara ett av följande värden:

För en transaktionspublikation:

60 = Fel
56 = Varning: prestandakritisk
52 = Varning: upphör snart eller har upphört att gälla
50 = Varning: prenumerationen är oinitierad
40 = Kommandot Försök att försöka igen misslyckades
30 = Körs inte (lyckades)
20 = Körs (startar, körs eller är inaktiv)

För en sammanslagningspublikation:

60 = Fel
56 = Varning: prestandakritisk
54 = Varning: långvarig sammanslagning
52 = Varning: upphör snart att gälla
50 = Varning: prenumerationen är oinitierad
40 = Kommandot Försök att försöka igen misslyckades
30 = Körs (startar, körs eller är inaktiv)
20 = Körs inte (lyckades)
distributionagentjobid binär(16) ID för distributionsagentjobbet för prenumerationer till en transaktionspublikation.
mergeagentjobid binär(16) ID för merge agent-jobbet för prenumerationer till en sammanslagningspublikation.
distributionagentid Int ID för distributionsagentjobbet för prenumerationen.
distributionagentprofileid Int ID för agentprofilen som används av distributionsagenten.
mergeagentid Int ID för jobbet Merge Agent för prenumerationen.
mergeagentprofileid Int ID för agentprofilen som används av sammanslagningsagenten.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

sp_replmonitorhelpsubscription används med alla typer av replikering.

sp_replmonitorhelpsubscription beställer resultatuppsättningen baserat på allvarlighetsgraden för prenumerationens status, vilket bestäms av värdet monitorrankingför . Till exempel sorteras rader för alla prenumerationer i ett feltillstånd ovanför rader för prenumerationer i varningstillstånd.

Behörigheter

Endast medlemmar i den fasta databasrollen db_owner eller replmonitor på distributionsdatabasen kan köra sp_replmonitorhelpsubscription.

Relaterat innehåll