sp_dbmmonitorresults (Transact-SQL)

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 = met à 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 au cours des 15 secondes antérieures ou que l'utilisateur n'est pas membre du rôle de serveur fixe sysadmin, sp_dbmmonitorresults, s'exécute sans mettre l'état à jour.

Valeurs des codes de retour

Aucune

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.

Notes

sp_dbmmonitorresults ne peut être exécutée que dans le contexte de la base de données msdb.

Autorisations

Nécessite l'appartenance au rôle de serveur fixe sysadmin ou au rôle de base de données fixe dbm_monitor dans la base de données msdb. Les membres du rôle dbm_monitor peuvent visualiser l'état de mise en miroir de bases de données, mais ne sont pas autorisés à le mettre à jour, ni à visualiser ou à configurer les événements de mise en miroir de bases de données.

[!REMARQUE]

À sa première exécution, sp_dbmmonitorupdate crée la table d'état de la mise en miroir de bases de données et le rôle de base de données fixe dbm_monitor dans la base de données msdb. Les membres du rôle de serveur fixe sysadmin peuvent ajouter n'importe quel utilisateur au rôle de base de données fixe dbm_monitor.

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 AdventureWorks2012, 2, 0;

Voir aussi

Référence

sp_dbmmonitorchangemonitoring (Transact-SQL)

sp_dbmmonitoraddmonitoring (Transact-SQL)

sp_dbmmonitordropmonitoring (Transact-SQL)

sp_dbmmonitorhelpmonitoring (Transact-SQL)

sp_dbmmonitorupdate (Transact-SQL)

Autres ressources

Surveillance de la mise en miroir de bases de données (SQL Server)