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 :