Хранимая процедура sp_replmonitorhelpsubscription (Transact-SQL)

Применимо к:SQL Server Управляемый экземпляр SQL Azure

Возвращает сведения о текущем состоянии подписок, относящихся к одной или нескольким публикациям на издателе, и одну строку для каждой возвращенной подписки. Эта хранимая процедура, используемая для наблюдения за репликацией, выполняется на распространителе в базе данных распространителя.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @publisher = ] 'publisher' Имя издателя, состояние которого отслеживается. publishersysname с значением NULL по умолчанию. Если значение NULL, данные возвращаются для всех издателей, использующих распространитель.

[ @publisher_db = ] 'publisher_db' Имя опубликованной базы данных. publisher_db — sysname с значением ПО умолчанию NULL. Если значение равно NULL, возвращаются сведения для всех баз данных, публикуемых данным издателем.

[ @publication = ] 'publication' Имя отслеживаемой публикации. публикацияsysname с значением NULL по умолчанию.

[ @publication_type = ] publication_type Если тип публикации. publication_type является int и может быть одним из этих значений.

значение Описание
0 Публикация транзакций.
1 Публикация моментальных снимков.
2 Публикация слиянием.
NULL (по умолчанию) Репликация пытается определить тип публикации.

[ @mode = ] mode Режим фильтрации, используемый при возврате сведений о мониторинге подписки. режим int и может быть одним из этих значений.

значение Описание
0 (по умолчанию) Возвращать все подписки.
1 Возвращать подписки с ошибками.
2 Возвращать подписки с предупреждениями о нарушениях пороговых показателей.
3 Возвращать подписки с ошибками или предупреждениями о нарушениях пороговых показателей.
4 Возвращает первые 25 худших выполняемых подписок.
5 Возвращать 50 подписок с худшей производительностью.
6 Возвращать подписки, синхронизируемые в данный момент.
7 Возвращать подписки, не синхронизируемые в данный момент.

[ @topnum = ] topnum Ограничивает результирующий набор только указанным числом подписок в верхней части возвращаемых данных. topnum является int, без значения по умолчанию.

[ @exclude_anonymous = ] exclude_anonymous Если анонимные подписки на вытягивание исключены из результирующий набор. exclude_anonymous бит с значением по умолчанию 0; значение 1 означает, что анонимные подписки исключены, а значение 0 означает, что они включены.

[ @refreshpolicy = ] refreshpolicy Только внутреннее использование.

Результирующие наборы

Имя столбца Тип данных Description
состояние int Проверяет состояние всех агентов репликации, связанных с публикацией, и возвращает самое высокое состояние из обнаруженных с учетом следующего порядка:

6 = сбой

5 = повторная попытка

2 = остановлено

4 = бездействия

3 = ход выполнения

1 = начало
предупреждение int Максимальный уровень предупреждений, выдаваемых подпиской, принадлежащей публикации; это значение может быть результатом операции логического OR над одним или несколькими из следующих значений:

1 = срок действия — подписка на публикацию транзакций не синхронизирована в течение порогового периода хранения.

2 = задержка — время, затраченное на реплика te данных от издателя транзакций к подписчику, превышает пороговое значение в секундах.

4 = слияние— подписка на публикацию слиянием не синхронизирована в течение порогового периода хранения.

8 = mergefastrunduration — время, затраченное на завершение синхронизации подписки на слияние, превышает пороговое значение в секундах по быстрому сетевому подключению.

16 = mergeslowrunduration — время, затраченное на завершение синхронизации подписки слиянием, превышает пороговое значение в секундах в течение медленного или удаленного сетевого подключения.

32 = mergefastrunspeed — скорость доставки строк во время синхронизации подписки на слияние не удалось поддерживать пороговое значение в строках в секунду через быстрое сетевое подключение.

64 = mergeslowrunspeed — скорость доставки строк во время синхронизации подписки на слияние не удалось поддерживать пороговое значение в строках в секунду при медленном или телефонном подключении.
subscriber sysname Имя подписчика.
subscriber_db sysname Имя базы данных, использующейся подпиской.
publisher_db sysname Имя базы данных публикации.
Публикации sysname Имя публикации.
publication_type int Тип публикации, может принимать одно из следующих значений:

0 = публикация транзакций

1 = публикация моментальных снимков

2 = публикация слиянием
subtype int Тип подписки может принимать одно из следующих значений:

0 = Push

1 = вытягивание

2 = анонимный
latency int Наибольшая задержка (в секундах) при изменении данных, зафиксированная для публикации транзакций агентом чтения журнала или агентом распространителя.
задержка int Максимальная задержка для публикации транзакций, при превышении которой создается предупреждение.
agentnotrunning int Время в часах, в течение которого агент не был запущен.
agentnotrunningthreshold int Время в часах, в течение которого агент может не быть запущен, но предупреждения не последует.
timetoexpiration int Время в часах, после которого срок действия подписки истекает, если она не будет синхронизирована.
срок действия int Время в часах, после которого срок действия подписки истекает, и создается предупреждение.
last_distsync datetime Дата и время последнего запуска агента распространителя.
distribution_agentname sysname Имя задания агента распространителя для подписки на публикацию транзакций.
mergeagentname sysname Имя задания агента слияния для подписки на публикацию слиянием.
mergesubscriptionfriendlyname sysname Понятное имя подписки.
mergeagentlocation sysname Имя сервера, на котором запущен агент слияния.
mergeconnectiontype int Соединение, использующееся для синхронизации подписки на публикацию слиянием, может быть одного из следующих типов:

1 = локальная сеть (LAN)

2 = подключение к сети с телефонным подключением

3 = веб-синхронизация.
mergePerformance int Производительность последней синхронизации по сравнению со всеми синхронизациями для данной подписки. Вычисляется как скорость доставки последней синхронизации, поделенная на среднее арифметическое скоростей доставки для всех предыдущих синхронизаций.
слияние float Скорость доставки последней синхронизации подписки.
слияние int Время, затраченное на последнюю синхронизацию подписки.
мониторинг int Ранжирующее значение для упорядочивания подписок в результирующем наборе может быть одним из следующих.

Для публикаций транзакций.

60 = ошибка

56 = предупреждение: критически важный для производительности

52 = предупреждение: истекает в ближайшее время или истекает

50 = предупреждение: подписка неинициализирована

40 = повторная ошибка команды

30 = не выполняется (успешно)

20 = Выполнение (запуск, запуск или простой)

Для публикаций слиянием.

60 = ошибка

56 = предупреждение: критически важный для производительности

54 = предупреждение: длительное слияние

52 = Предупреждение: истекает в ближайшее время

50 = предупреждение: подписка неинициализирована

40 = повторная ошибка команды

30 = выполнение (запуск, запуск или простой)

20 = не выполняется (успешно)
distributionagentjobid binary(16) Идентификатор задания агента распространителя для подписки на публикацию транзакций.
mergeagentjobid binary(16) Идентификатор задания агента слияния для подписки на публикацию слиянием.
distributionagentid int Идентификатор задания агента распространителя для подписки.
distributionagentprofileid int Идентификатор профиля агента распространителя.
mergeagentid int Идентификатор задания агента слияния для подписки.
mergeagentprofileid int Идентификатор профиля агента слияния.

Значения кода возврата

0 (успешно) или 1 (сбой)

Замечания

sp_replmonitorhelpsubscription используется со всеми типами реплика tion.

sp_replmonitorhelpsubscription упорядочивает результирующий набор на основе серьезности состояния подписки, которая определяется значением отслеживания. Например, строки всех подписок в состоянии ошибки находятся выше строк подписок с предупреждениями.

Разрешения

Только члены предопределенной роли базы данных db_owner или replmonitor в базе данных распространителя могут выполнять sp_replmonitorhelpsubscription.

См. также

Наблюдение за репликацией программным образом