sp_replmonitorhelppublisher (Transact-SQL)

  • Article

Applies to: SQL Server Azure SQL Managed Instance

Returns current status information for one or more Publishers associated with a Distributor. This stored procedure, which is used to monitor replication, is executed at the Distributor on the distribution database.

Transact-SQL syntax conventions

Syntax

sp_replmonitorhelppublisher
    [ [ @publisher = ] N'publisher' ]
    [ , [ @refreshpolicy = ] refreshpolicy ]
[ ; ]

Arguments

[ @publisher = ] N'publisher'

The name of the Publisher the status of which is being monitored. @publisher is sysname, with a default of NULL. If NULL, information is returned for all Publishers that use the Distributor.

[ @refreshpolicy = ] refreshpolicy

Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.

Result set

Column name Data type Description
publisher sysname The name of a Publisher.
distribution_db sysname The name of the distribution database used by a given Publisher.
status int Maximum status of all replication agents associated with publications at this Publisher, which can be one of these values.

1 = Started
2 = Succeeded
3 = In progress
4 = Idle
5 = Retrying
6 = Failed
warning int Maximum threshold warning generated by a subscription belonging to a publication at this Publisher, which can be the logical OR result of one or more of these values.

1 = expiration - a subscription to a transactional publication hasn't synchronized within the retention period threshold.
2 = latency - the time taken to replicate data from a transactional Publisher to the Subscriber exceeds the threshold, in seconds.
4 = mergeexpiration - a subscription to a merge publication hasn't synchronized within the retention period threshold.
8 = mergefastrunduration - the time taken to complete synchronization of a merge subscription exceeds the threshold, in seconds, over a fast network connection.
16 = mergeslowrunduration - the time taken to complete synchronization of a merge subscription exceeds the threshold, in seconds, over a slow network connection.
32 = mergefastrunspeed - the delivery rate for rows during synchronization of a merge subscription failed to maintain the threshold rate, in rows per second, over a fast network connection.
64 = mergeslowrunspeed - the delivery rate for rows during synchronization of a merge subscription failed to maintain the threshold rate, in rows per second, over a slow network connection.
publicationcount int The number of publications belonging to the Publisher.

Return code values

0 (success) or 1 (failure).

Remarks

sp_replmonitorhelppublisher is used with all types of replication.

Permissions

Only members of the sysadmin fixed server role at the Distributor or members of the db_owner or replmonitor fixed database roles in the distribution database can execute sp_replmonitorhelppublisher.

Related content