sp_dbmmonitorresults (Transact-SQL)

  • Article

S’applique à :SQL Server

Retourne les lignes d'état d'une base de données surveillée, à partir de la table d'état dans laquelle est stocké l'historique de la surveillance de la mise en miroir de bases de données, et vous permet de choisir si la procédure doit au préalable obtenir le dernier état.

Conventions de la syntaxe Transact-SQL

Syntaxe

  
sp_dbmmonitorresults database_name   
   , rows_to_return  
    , update_status

Arguments

database_name
Spécifie la base de données dont l'état de mise en miroir doit être retourné.

rows_to_return
Spécifie la quantité de lignes retournées :

0 = Dernière ligne

1 = Lignes des deux dernières heures

2 = Lignes des quatre dernières heures

3 = Lignes des huit dernières heures

4 = Lignes du dernier jour

5 = Lignes des deux derniers jours

6 = 100 dernières lignes

7 = 500 dernières lignes

8 = 1 000 dernières lignes

9 = 1 000 000 dernières lignes

update_status
Spécifie qu'avant de retourner les résultats, la procédure :

0 = ne met pas à jour l'état de la base de données. Les résultats sont calculés à l'aide des deux dernières lignes uniquement, dont l'âge dépend du moment auquel la table d'état a été actualisée ;

1 = Mises à jour l’état de la base de données en appelant sp_dbmmonitorupdate avant de calculer les résultats. Toutefois, si la table d’état a été mise à jour dans les 15 secondes précédentes, ou si l’utilisateur n’est pas membre du rôle serveur fixe sysadmin , sp_dbmmonitorresults s’exécute sans mettre à jour l’état.

Codet de retour

Aucun

Jeux de résultats

Retourne le nombre demandé de lignes de l'état d'historique pour la base de données spécifiée. Chaque ligne contient les informations suivantes :

Nom de la colonne Type de données Description
database_name sysname Nom d'une base de données mise en miroir.
role int Rôle de mise en miroir actuel de l'instance du serveur :

1 = Principal

2 = Miroir
mirroring_state int État de la base de données :

0 = Suspendu

1 = Déconnecté

2 = Synchronisation

3 = Basculement en attente

4 = Synchronisé
witness_status int L'état de connexion du témoin dans la session de mise en miroir de la base de données peut être :

0 = Inconnu

1 = Connecté

2 = Déconnecté
log_generation_rate int Quantité de journal générée, en kilo-octets/s, depuis la précédente mise à jour de l'état de mise en miroir de cette base de données.
unsent_log int Taille, en kilo-octets, du journal non envoyé dans la file d'attente d'envoi sur le principal.
send_rate int Débit d'envoi du journal, en kilo-octets/s, depuis le principal vers le serveur miroir.
unrestored_log int Taille, en kilo-octets, de la file d'attente de restauration par progression sur le serveur miroir.
recovery_rate int Débit de la restauration par progression sur le serveur miroir, en kilo-octets/s.
transaction_delay int Délai total, en millisecondes, de toutes les transactions.
transactions_per_sec int Nombre de transactions par seconde sur l'instance du serveur principal.
average_delay int Délai moyen de chaque transaction sur l'instance du serveur principal grâce à la mise en miroir de bases de données. En mode hautes performances (c'est-à-dire, lorsque la propriété SAFETY a pour valeur OFF), cette valeur est généralement 0.
time_recorded datetime Heure à laquelle la ligne a été enregistrée lors de la surveillance de la mise en miroir de bases de données. Il s'agit de l'heure système du principal.
time_behind datetime Heure système approximative du principal sur laquelle la base de données miroir est actuellement synchronisée. Cette valeur n'est significative que sur l'instance du serveur principal.
local_time datetime Heure système sur l'instance du serveur local à laquelle cette ligne a été mise à jour.

Remarques

sp_dbmmonitorresults peuvent être exécutés uniquement dans le contexte de la base de données msdb .

Autorisations

Nécessite l’appartenance au rôle serveur fixe sysadmin ou au rôle de base de données fixe dbm_monitor dans la base de données msdb . Le rôle dbm_monitor permet à ses membres d’afficher l’état de la mise en miroir de bases de données, mais pas de le mettre à jour, mais pas d’afficher ou de configurer les événements de mise en miroir de bases de données.

Notes

La première fois que sp_dbmmonitorupdate s’exécute, il crée le rôle de base de données fixe dbm_monitor dans la base de données msdb . Les membres du rôle serveur fixe sysadmin peuvent ajouter n’importe quel utilisateur au dbm_monitor rôle de base de données fixe.

Exemples

L'exemple suivant retourne les lignes enregistrées au cours des deux heures précédentes sans mettre à jour l'état de la base de données.

USE msdb;  
EXEC sp_dbmmonitorresults AdventureWorks2022, 2, 0;

Voir aussi

Surveillance de la mise en miroir de bases de données (SQL Server)
sp_dbmmonitorchangemonitoring (Transact-SQL)
sp_dbmmonitoraddmonitoring (Transact-SQL)
sp_dbmmonitordropmonitoring (Transact-SQL)
sp_dbmmonitorhelpmonitoring (Transact-SQL)
sp_dbmmonitorupdate (Transact-SQL)