sp_replmonitorhelpsubscription (Transact-SQL)

platí pro:SQL Serverazure SQL Managed Instance

Vrátí aktuální informace o stavu pro odběry patřící do jedné nebo více publikací v Publisheru a vrátí jeden řádek pro každé vrácené předplatné. Tato uložená procedura, která se používá k monitorování replikace, se provádí u distributora v distribuční databázi.

Transact-SQL konvence syntaxe

Syntaxe

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

Argumenty

[ @publisher = ] N'vydavatele'

Název vydavatele, jehož stav se monitoruje. @publisher je sysname , s výchozím NULL. Pokud je hodnota null, vrátí se informace pro všechny vydavatele, kteří používají distributora.

[ @publisher_db = ] N'publisher_db'

Název publikované databáze. @publisher_db je sysname s výchozím nastavením NULL. Pokud NULLse vrátí informace pro všechny publikované databáze v Publisheru.

[ @publication = ] N'publication'

Název monitorované publikace. @publication je sysname s výchozím nastavením NULL.

[ @publication_type = ] publication_type

Je-li typ publikace. @publication_type je int a může to být jedna z těchto hodnot.

Hodnota	Popis
0	Transakční publikace.
1	Publikování snímků
2	Sloučit publikaci.
NULL (výchozí)	Replikace se pokusí určit typ publikace.

[ @mode = ] režim

Režim filtrování, který se má použít při vracení informací monitorování předplatného. @mode je int a může to být jedna z těchto hodnot.

Hodnota	Popis
0 (výchozí)	Vrátí všechna předplatná.
1	Vrátí pouze předplatná s chybami.
2	Vrátí pouze předplatná, která generují upozornění na prahovou hodnotu metriky.
3	Vrátí pouze předplatná, která mají chyby nebo generují upozornění na prahovou hodnotu metriky.
4	Vrátí 25 nejlepších předplatných s nejhorším výkonem.
5	Vrátí 50 nejlepších předplatných s nejhorším výkonem.
6	Vrátí pouze předplatná, která se právě synchronizují.
7	Vrátí pouze předplatná, která se momentálně nesynchronují.

[ @topnum = ] topnum

Omezí sadu výsledků jenom na zadaný počet předplatných v horní části vrácených dat. @topnum je int, s výchozí hodnotou NULL.

[ @exclude_anonymous = ] exclude_anonymous

Pokud jsou anonymní odběry vyžádané replikace vyloučené ze sady výsledků. @exclude_anonymous je bit, s výchozím nastavením 0.

• Hodnota 1 znamená, že anonymní předplatná jsou vyloučená.
• Hodnota 0 znamená, že jsou zahrnuté.

[ @refreshpolicy = ] refreshpolicy

Určeno pouze pro informační účely. Není podporováno. Budoucí kompatibilita není zaručena.

Sada výsledků

Název sloupce	Datový typ	Popis
status	Int	Zkontroluje stav všech agentů replikace přidružených k publikaci a vrátí nejvyšší stav nalezený v následujícím pořadí: 6 = Selhání 5 = Opakování 2 = Zastaveno 4 = Nečinné 3 = Probíhá 1 = Spuštěno
warning	Int	Maximální prahová hodnota vygenerovaná odběrem, který patří do publikace, což může být logický výsledek OR jedné nebo více těchto hodnot. 1 = expiration – odběr transakční publikace se nesynchronoval v rámci prahové hodnoty doby uchovávání. 2 = latency – doba potřebná k replikaci dat z transakčního vydavatele na odběratele překračuje prahovou hodnotu v sekundách. 4 = mergeexpiration – odběr publikace hromadné korespondence se nesynchronoval v rámci prahové hodnoty doby uchovávání. 8 = mergefastrunduration – doba potřebná k dokončení synchronizace předplatného sloučení překračuje prahovou hodnotu v sekundách přes rychlé síťové připojení. 16 = mergeslowrunduration – doba potřebná k dokončení synchronizace předplatného sloučení překračuje prahovou hodnotu v sekundách po pomalém síťovém připojení. 32 = mergefastrunspeed – rychlost doručení pro řádky během synchronizace odběru sloučení se nepodařilo zachovat prahovou rychlost v řádcích za sekundu přes rychlé síťové připojení. 64 = mergeslowrunspeed – rychlost doručení řádků během synchronizace odběru sloučení se nepodařilo zachovat prahovou rychlost v řádcích za sekundu přes pomalé síťové připojení.
subscriber	sysname	Název odběratele.
subscriber_db	sysname	Název databáze používané pro předplatné.
publisher_db	sysname	Název databáze publikace.
publication	sysname	Název publikace.
publication_type	Int	Typ publikace, který může být jednou z těchto hodnot: 0 = Transakční publikace 1 = Publikování snímků 2 = Sloučit publikaci
subtype	Int	Typ předplatného, který může být jedna z následujících hodnot: 0 = Nasdílení změn 1 = Pull 2 = Anonymní
latency	Int	Nejvyšší latence v sekundách pro změny dat šířených čtenářem protokolů nebo distribučními agenty pro transakční publikaci.
latencythreshold	Int	Maximální latence pro transakční publikaci, nad kterou je vyvolána upozornění.
agentnotrunning	Int	Doba v hodinách, během které se agent nespustí.
agentnotrunningthreshold	Int	Doba v hodinách, po kterou se agent nespustí, než se vyvolá upozornění.
timetoexpiration	Int	Doba v hodinách před vypršením platnosti předplatného, pokud není synchronizována.
expirationthreshold	Int	Čas v hodinách před vypršením platnosti předplatného, kdy se vyvolá upozornění.
last_distsync	datum a čas	Datum a čas posledního spuštění distribučního agenta.
distribution_agentname	sysname	Název úlohy distribučního agenta pro odběr transakční publikace.
mergeagentname	sysname	Název úlohy sloučit agenta pro předplatné pro slučovací publikaci.
mergesubscriptionfriendlyname	sysname	Popisný název předaný předplatnému
mergeagentlocation	sysname	Název serveru, na kterém běží agent sloučení.
mergeconnectiontype	Int	Připojení používané při synchronizaci předplatného s hromadnou publikací, což může být jedna z následujících hodnot: 1 = místní síť LAN (Local Area Network) 2 = telefonické připojení k síti 3 = Synchronizace webu.
mergePerformance	Int	Výkon poslední synchronizace ve srovnání se všemi synchronizacemi pro předplatné, která je založená na rychlosti doručení poslední synchronizace vydělené průměrem všech předchozích sazeb doručení.
mergerunspeed	plout	Míra doručení poslední synchronizace předplatného.
mergerunduration	Int	Doba dokončení poslední synchronizace předplatného.
monitorranking	Int	Hodnota řazení použitá k seřazení předplatných v sadě výsledků a může být jedna z těchto hodnot: Pro transakční publikaci: 60 = Chyba 56 = Upozornění: Kritický výkon 52 = Upozornění: Brzy vyprší nebo vypršela platnost 50 = Upozornění: neinicializované předplatné 40 = Opakování neúspěšného příkazu 30 = Neběží (úspěch) 20 = Spuštěno (spuštění, spuštění nebo nečinnost) Pro slučovací publikaci: 60 = Chyba 56 = Upozornění: Kritický výkon 54 = Upozornění: Dlouhotrvající sloučení 52 = Upozornění: Brzy vyprší platnost 50 = Upozornění: neinicializované předplatné 40 = Opakování neúspěšného příkazu 30 = Spuštěno (spuštění, spuštění nebo nečinnost) 20 = Neběží (úspěch)
distributionagentjobid	binární(16)	ID úlohy distribučního agenta pro odběry transakční publikace.
mergeagentjobid	binární(16)	ID úlohy sloučit agenta pro předplatná ke sloučení publikace.
distributionagentid	Int	ID úlohy distribučního agenta pro předplatné.
distributionagentprofileid	Int	ID profilu agenta používaného distribučním agentem.
mergeagentid	Int	ID úlohy sloučit agenta pro předplatné.
mergeagentprofileid	Int	ID profilu agenta používaného agentem sloučení

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Poznámky

sp_replmonitorhelpsubscription se používá se všemi typy replikace.

sp_replmonitorhelpsubscription seřídí sadu výsledků na základě závažnosti stavu předplatného, který je určen hodnotou monitorranking. Například řádky pro všechna předplatná v chybovém stavu jsou seřazené nad řádky pro předplatná ve stavu upozornění.

Povolení

Spustit můžou pouze členové db_owner nebo sp_replmonitorhelpsubscription pevnou roli databáze v distribuční databázi .

Související obsah

• Programové monitorování replikace