sp_replmonitorhelppublication (Transact-SQL)
Возвращает сведения о текущем состоянии одной или нескольких публикаций, содержащихся на издателе. Эта хранимая процедура, используемая для наблюдения за репликацией, выполняется на стороне распространителя в базе данных распространителя.
.gif "Значок ссылки на раздел")
Синтаксические обозначения в Transact-SQL
Синтаксис
sp_replmonitorhelppublication [ @publisher = ] 'publisher'
[ , [ @publisher_db = ] 'publisher_db'
[ , [ @publication = ] 'publication'
[ , [ @publication_type = ] publication_type ]
[ , [ @refreshpolicy = ] refreshpolicy ]
Аргументы
- [ @publisher = ] 'publisher'
Имя издателя, состояние которого отслеживается. Аргумент publisher имеет тип sysname и значение по умолчанию NULL. Если значение аргумента NULL, то будут возвращены данные по всем издателям, которые используют данный распространитель.
- [ @publisher_db = ] 'publisher_db'
Имя опубликованной базы данных. Аргумент publisher_db имеет тип sysname и значение по умолчанию NULL. Если значение аргумента равно NULL, то возвращаются сведения по всем базам данных, публикуемых данным издателем.
- [ @publication = ] 'publication'
Имя отслеживаемой публикации. Аргумент publication имеет тип sysname и значение по умолчанию NULL.
[ @publication_type = ] publication_type
Тип публикации. Аргумент publication_type имеет тип int и может иметь одно из следующих значений.Значение Описание 0
Публикация транзакций.
1
Публикация моментальных снимков.
2
Публикация слиянием.
Значение NULL (по умолчанию)
Репликация пытается определить тип публикации.
- [ @refreshpolicy= ] refreshpolicy
Только для внутреннего использования.
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Результирующие наборы
| Имя столбца | Тип данных | Описание |
|---|---|---|
publisher_db |
sysname |
Имя издателя. |
publication |
sysname |
Имя публикации. |
publication_type |
int |
Тип публикации, который может принимать одно из следующих значений: 0 = публикация транзакций; 1 = публикация моментальных снимков; 2 = публикация слиянием. |
status |
int |
Реальное состояние всех агентов репликации, связанных с публикацией, которое может принимать одно из следующих значений: 1 = запущено; 2 = успешно выполнено; 3 = в процессе выполнения; 4 = бездействие; 5 = повтор; 6 = ошибка. |
warning |
int |
Максимальный уровень предупреждений, выдаваемых подпиской, принадлежащей публикации; это значение может быть результатом логической операции ИЛИ над одним или несколькими из следующих значений: 1 = expiration — истечение срока — подписка на публикацию транзакций не была синхронизирована в течение порогового срока хранения; 2 = latency — задержка — время превышения над пороговым значением, в секундах, требуемое для репликации транзакций данных от издателя к подписчику; 4 = mergeexpiration — подписка на публикацию слиянием не была синхронизирована с пороговым сроком хранения; 8 = mergefastrunduration — превышение времени, потребовавшегося для завершения синхронизации подписки слиянием, над пороговым значением, в секундах, через быстрое сетевое соединение; 16 = mergeslowrunduratio — превышение времени, потребовавшегося для завершения синхронизации подписки слиянием, над пороговым значением, в секундах, через медленное или модемное сетевое соединение; 32 = mergefastrunspeed — превышение порога скорости доставки строк в процессе синхронизации подписки слиянием, в единицах строк в секунду, через быстрое сетевое соединение; 64 = mergefastrunspeed — превышение порога скорости доставки строк в процессе синхронизации подписки слиянием, в единицах строк в секунду, через медленное или модемное сетевое соединение. |
worst_latency |
int |
Наибольшая задержка (в секундах) при изменении данных, зафиксированная для публикации транзакций агентом чтения журнала или агентами распространителя. |
best_latency |
int |
Наименьшая задержка (в секундах) изменения данных, зафиксированная для публикации транзакций агентом чтения журнала или агентом распространителя. |
average_latency |
int |
Средняя задержка (в секундах) изменения данных, зафиксированная для публикации транзакций агентом чтения журнала или агентом распространителя. |
last_distsync |
datetime |
Дата и время последнего запуска агента распространителя. |
retention |
int |
Срок хранения публикации. |
latencythreshold |
int |
Порог задержки, установленный для публикации транзакций. |
expirationthreshold |
int |
Порог истечения, установленный для публикации в случае публикации слиянием. |
agentnotrunningthreshold |
int |
Порог, установленный для самого долгого времени, в течение которого агент не работает. |
subscriptioncount |
int |
Количество подписок на публикацию. |
runningdistagentcount |
int |
Количество агентов распространителя, запущенных для публикации. |
snapshot_agentname |
sysname |
Имя задания агента моментальных снимков для публикации. |
logreader_agentname |
sysname |
Имя задания агента чтения журнала для публикации транзакций. |
qreader_agentname |
sysname |
Имя задания агента чтения очереди для публикации транзакций, поддерживающей обновление посредством очередей. |
worst_runspeedPerf |
int |
Наибольшее время синхронизации для публикации слиянием. |
best_runspeedPerf |
int |
Наименьшее время синхронизации для публикации слиянием. |
average_runspeedPerf |
int |
Среднее время синхронизации для публикации слиянием. |
retention_period_unit |
int |
Единица, используемая для выражения значения retention. |
Замечания
Процедура sp_replmonitorhelppublication используется со всеми типами репликации.
Разрешения
Только члены фиксированных ролей баз данных db_owner или replmonitor на базе данных распространителя могут выполнять процедуру sp_replmonitorhelppublication.
См. также
Другие ресурсы
How to: Programmatically Monitor Replication (Replication Transact-SQL Programming)