Partage via


sys.database_connection_stats (Azure SQL Database)

S’applique à : Azure SQL Database

Contient des statistiques pour les événements de connectivité de base de données SQL Database, fournissant une vue d’ensemble des réussites et des échecs de connexion de base de données. Pour plus d’informations sur les événements de connectivité, consultez Types d’événements dans sys.event_log (Azure SQL Database).

Statistique Type Description
database_name sysname Nom de la base de données.
heure-début datetime2 Date et heure UTC indiquant le début de l'intervalle d'agrégation. L'heure est toujours un multiple de 5 minutes. Par exemple :

'2022-03-30 16:00:00'
'2022-03-30 16:05:00'
'2022-03-30 16:10:00'
heure-fin datetime2 Date et heure UTC indiquant la fin de l'intervalle d'agrégation. End_time est toujours exactement 5 minutes plus tard que le start_time correspondant dans la même ligne.
success_count int Nombre de connexions réussies.
total_failure_count int Nombre total d'échecs de connexion. Il s’agit de la somme de connection_failure_count, de terminated_connection_count et de throttled_connection_count, et n’inclut pas d’événements d’interblocage.
connection_failure_count int Nombre d'échecs de connexion.
terminated_connection_count int Cette colonne n’est pas utilisée et est conservée pour la compatibilité descendante.
throttled_connection_count int Cette colonne n’est pas utilisée et est conservée pour la compatibilité descendante.

Notes

Agrégation des événements

Les informations relatives aux événements de cette vue sont collectées et agrégées par intervalles de 5 minutes. Les colonnes de nombre représentent le nombre de fois qu'un événement particulier de connectivité s'est produit pour une base de données spécifique dans un intervalle de temps donné.

Par exemple, si un utilisateur ne parvient pas à se connecter à la base de données Database1 sept fois entre 11:00 et 11:05 le 30 mars 2022 (UTC), ces informations sont disponibles dans une seule ligne dans cette vue :

database_name heure-début heure-fin success_count total_failure_count connection_failure_count terminated_connection_count throttled_connection_count
Database1 2022-03-30 11:00:00 2022-03-30 11:05:00 0 7 7 0 0

Heure de début (start_time) et heure de fin (end_time) de l'intervalle

Un événement est inclus dans un intervalle d’agrégation lorsque l’événement se produit sur ou après start_time et avant end_time pour cet intervalle. Par exemple, un événement se produisant exactement à 2022-03-30 19:25:00.0000000 est inclus uniquement dans le deuxième intervalle indiqué ci-dessous :

start_time                    end_time  
2022-03-30 19:20:00.0000000   2022-03-30 19:25:00.0000000  
2022-03-30 19:25:00.0000000   2022-03-30 19:30:00.0000000  

Mises à jour des données

Les données de cette vue sont cumulées au fil du temps. Généralement, les données sont cumulées pendant une heure à compter du début de l'intervalle d'agrégation, mais cela peut prendre jusqu'à 24 heures avant que toutes les données apparaissent dans la vue. Pendant ce temps, les informations d'une seule ligne peuvent être mises à jour périodiquement.

Conservation des données

Les données de cette vue sont conservées pendant un maximum de 30 jours, ou éventuellement moins selon le nombre de bases de données et le nombre d’événements uniques générés par chaque base de données. Pour conserver ces informations plus longtemps, copiez les données dans une base de données distincte. Une fois que vous avez effectué une copie initiale de la vue, les lignes de la vue peuvent être mises à jour au fur et à mesure que les données sont cumulées. Pour tenir à jour votre copie des données, effectuez périodiquement une analyse des lignes de la table pour détecter une augmentation du nombre d'événements dans les lignes existantes et pour identifier les nouvelles lignes (vous pouvez identifier les lignes qui sont uniques à l'aide des heures de début et de fin), puis mettez à jour votre copie des données en fonction de ces modifications.

Erreurs non incluses

Cette vue peut ne pas inclure toutes les informations de connexion et d'erreur :

  • Cette vue n’inclut pas toutes les erreurs de base de données SQL Database qui peuvent se produire, uniquement celles spécifiées dans les types d’événements dans sys.event_log (Azure SQL Database).
  • En cas de défaillance de machine dans le centre de données SQL Database, une petite quantité de données peut être manquante dans la table d’événements.
  • Si une adresse IP a été bloquée via DoSGuard, les événements de tentative de connexion de cette adresse IP ne peuvent pas être collectés et n’apparaissent pas dans cette vue.

autorisations

Nécessite l’autorisation d’accéder à la base de données master sur le serveur logique dans Azure SQL Database.

Exemples

Cet exemple interroge sys.database_connection_stats pour retourner un résumé des connexions de base de données qui se sont produites entre midi le 29 mars 2022 et midi le 30 mars 2022 (UTC). Connectez-vous à la base de données master sur le serveur logique dans Azure SQL Database pour exécuter la requête.

SELECT database_name, start_time, end_time, success_count, total_failure_count, connection_failure_count
FROM sys.database_connection_stats
WHERE start_time>='2022-03-29 12:00:00' and end_time<='2022-03-30 12:00:00'
ORDER BY start_time ASC; 

Étapes suivantes

Pour en savoir plus sur Azure SQL Database, consultez les articles suivants :