sp_replmonitorhelpsubscription (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

Renvoie des informations sur l'état actuel d'abonnements appartenant à une ou plusieurs publications du serveur de publication, et retourne une ligne pour chaque abonnement retourné. Cette procédure stockée, utilisée pour surveiller la réplication, est exécutée sur la base de données du serveur de distribution.

Conventions de la syntaxe Transact-SQL

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

Arguments

[ @publisher = ] N’publisher'

Nom du serveur de publication dont l’état est surveillé. @publisher est sysname, avec la valeur par défaut NULL. Si la valeur est Null, les informations sont retournées pour tous les serveurs de publication qui utilisent le serveur de distribution.

[ @publisher_db = ] N’publisher_db'

Nom de la base de données publiée. @publisher_db est sysname, avec la valeur par défaut NULL. Si NULL, les informations sont retournées pour toutes les bases de données publiées sur le serveur de publication.

[ @publication = ] N’publication'

Nom de la publication surveillée. @publication est sysname, avec la valeur par défaut NULL.

[ @publication_type = ] publication_type

Type de publication. @publication_type est int et peut être l’une de ces valeurs.

Valeur	Description
0	Publication transactionnelle.
1	Publication d'instantané.
2	Publication de fusion.
NULL (valeur par défaut)	La réplication tente de déterminer le type de publication.

[ @mode = ] mode

Mode de filtrage à utiliser lors du renvoi des informations de surveillance d’abonnement. @mode est int et peut être l’une de ces valeurs.

Valeur	Description
0 (valeur par défaut)	Retourne tous les abonnements.
1	Retourne uniquement les abonnements qui ont des erreurs.
2	Retourne uniquement les abonnements qui génèrent des avertissements de métrique de seuil.
3	Retourne uniquement les abonnements qui présentent des erreurs ou génèrent des avertissements de métrique de seuil.
4	Retourne les 25 premiers abonnements les plus performants.
5	Retourne les 50 abonnements les moins performants.
6	Retourne uniquement les abonnements en cours de synchronisation.
7	Retourne uniquement les abonnements qui ne sont actuellement pas synchronisés.

[ @topnum = ] topnum

Limite l'ensemble de résultats au nombre d'abonnements spécifié au début des données retournées. @topnum est int, avec la valeur par défaut NULL.

[ @exclude_anonymous = ] exclude_anonymous

Si les abonnements par extraction anonyme sont exclus du jeu de résultats. @exclude_anonymous est bit, avec la valeur par défaut 0.

• Valeur de 1 signifie que les abonnements anonymes sont exclus.
• Une valeur de 0 signifie qu’elles sont incluses.

[ @refreshpolicy = ] refreshpolicy

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

Jeu de résultats

Nom de la colonne	Type de données	Description
status	int	Examine l'état de tous les agents de réplication associés à la publication, puis retourne l'état le plus élevé dans l'ordre suivant : 6 = Échec 5 = Nouvelle tentative 2 = Arrêté 4 = Inactif 3 = En cours 1 = Démarré
warning	int	Avertissement de seuil maximal généré par un abonnement appartenant à la publication, qui peut être le résultat OR logique d'au moins l'une des valeurs suivantes. 1 = expiration : un abonnement à une publication transactionnelle n’a pas été synchronisé dans le seuil de période de rétention. 2 = latency - le temps nécessaire pour répliquer les données d’un serveur de publication transactionnel vers l’Abonné dépasse le seuil, en secondes. 4 = mergeexpiration : un abonnement à une publication de fusion n’a pas été synchronisé dans le seuil de période de rétention. 8 = mergefastrunduration - le temps nécessaire pour terminer la synchronisation d’un abonnement de fusion dépasse le seuil, en secondes, sur une connexion réseau rapide. 16 = mergeslowrunduration - le temps nécessaire pour terminer la synchronisation d’un abonnement de fusion dépasse le seuil, en secondes, sur une connexion réseau lente. 32 = mergefastrunspeed : le taux de remise des lignes pendant la synchronisation d’un abonnement de fusion n’a pas pu maintenir le taux de seuil, en lignes par seconde, sur une connexion réseau rapide. 64 = mergeslowrunspeed : le taux de remise des lignes pendant la synchronisation d’un abonnement de fusion n’a pas réussi à maintenir le taux de seuil, en lignes par seconde, sur une connexion réseau lente.
subscriber	sysname	Nom de l'Abonné.
subscriber_db	sysname	Nom de la base de données utilisée pour l’abonnement.
publisher_db	sysname	Nom de la base de données de publication.
publication	sysname	Nom d’une publication.
publication_type	int	Type de publication, que peut prendre l'une des valeurs suivantes : 0 = Publication transactionnelle 1 = Publication d’instantanés 2 = Publication de fusion
subtype	int	Type d’abonnement, qui peut être l’une des valeurs suivantes : 0 = Push 1 = Extraction 2 = Anonyme
latency	int	Latence maximale, en secondes, des modifications de données propagées par l'Agent de lecture du journal ou l'Agent de distribution pour une publication transactionnelle.
latencythreshold	int	Latence maximale pour la publication transactionnelle, au-dessus de laquelle un avertissement est déclenché.
agentnotrunning	int	Durée, en heures, pendant laquelle l’agent n’a pas été exécuté.
agentnotrunningthreshold	int	Durée, en heures, pendant laquelle l’agent n’a pas été exécuté avant qu’un avertissement ne soit déclenché.
timetoexpiration	int	Durée, en heures, avant l’expiration de l’abonnement s’il n’est pas synchronisé.
expirationthreshold	int	Heure, en heures, avant l’expiration de l’abonnement, qu’un avertissement est déclenché.
last_distsync	datetime	Date/heure de la dernière exécution du Agent de distribution.
distribution_agentname	sysname	Nom du travail Agent de distribution pour l’abonnement à une publication transactionnelle.
mergeagentname	sysname	Nom du travail Agent de fusion de l’abonnement à une publication de fusion.
mergesubscriptionfriendlyname	sysname	Nom convivial donné à l’abonnement.
mergeagentlocation	sysname	Nom du serveur sur lequel s’exécute le Agent de fusion.
mergeconnectiontype	int	Connexion utilisée lors de la synchronisation d'un abonnement à une publication de fusion ; ce paramètre peut prendre l'une des valeurs suivantes : 1 = réseau local (LAN) 2 = connexion réseau rendez-vous 3 = Synchronisation web.
mergePerformance	int	Performances de la dernière synchronisation comparées à toutes les synchronisations de l'abonnement, calculées en divisant la vitesse de transmission de la dernière synchronisation par la moyenne de toutes les vitesses de transmission antérieures.
mergerunspeed	float	Taux de remise de la dernière synchronisation de l’abonnement.
mergerunduration	int	Durée d’exécution de la dernière synchronisation de l’abonnement.
monitorranking	int	La valeur de classement utilisée pour classer les abonnements dans le jeu de résultats et peut être l’une des valeurs suivantes : Dans le cas d'une publication transactionnelle : 60 = Erreur 56 = Avertissement : critique pour les performances 52 = Avertissement : expiration ou expiration 50 = Avertissement : abonnement non initialisé 40 = Nouvelle tentative de commande ayant échoué 30 = Non en cours d’exécution (réussite) 20 = Exécution (démarrage, exécution ou inactivité) Dans le cas d'une publication de fusion : 60 = Erreur 56 = Avertissement : critique pour les performances 54 = Avertissement : fusion longue 52 = Avertissement : expiration bientôt 50 = Avertissement : abonnement non initialisé 40 = Nouvelle tentative de commande ayant échoué 30 = Exécution (démarrage, exécution ou inactivité) 20 = Non en cours d’exécution (réussite)
distributionagentjobid	binary(16)	ID du travail d'Agent de distribution pour les abonnements à une publication transactionnelle.
mergeagentjobid	binary(16)	ID du travail d'Agent de fusion pour les abonnements à une publication de fusion.
distributionagentid	int	ID du travail d'Agent de distribution pour l'abonnement.
distributionagentprofileid	int	ID du profil d'Agent utilisé par l'Agent de distribution.
mergeagentid	int	ID du travail d'Agent de fusion pour l'abonnement.
mergeagentprofileid	int	ID du profil d'Agent utilisé par l'Agent de fusion.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

sp_replmonitorhelpsubscription est utilisé avec tous les types de réplication.

sp_replmonitorhelpsubscription commande le jeu de résultats en fonction de la gravité de l’état de l’abonnement, qui est déterminé par la valeur de monitorranking. Par exemple, les lignes de tous les abonnements se trouvant dans un état d'erreur précèdent les lignes des abonnements se trouvant dans un état d'avertissement.

autorisations

Seuls les membres du rôle de base de données fixe db_owner ou replmonitor sur la base de données de distribution peuvent s’exécuter sp_replmonitorhelpsubscription.

Contenu connexe

• Surveiller la réplication par programmation