Interrogation de données à partir d’Azure Time Series Insights Gen2
Note
Le service Time Series Insights sera mis hors service le 7 juillet 2024. Envisagez de migrer des environnements existants vers d’autres solutions dès que possible. Pour plus d’informations sur la dépréciation et la migration, consultez notre documentation .
Azure Time Series Insights Gen2 permet d’interroger des données sur les événements et les métadonnées stockés dans l’environnement via des API de surface publique. Ces API sont également utilisées par l'Explorateur Azure Time Series Insights TSI.
Trois catégories d’API principales sont disponibles dans Azure Time Series Insights Gen2 :
- API d’environnement: ces API activent des requêtes sur l’environnement Azure Time Series Insights Gen2 lui-même. Ils peuvent être utilisés pour collecter la liste des environnements auxquels l’appelant a accès et les métadonnées d’environnement.
- APIs de la série chronologique Model-Query (TSM-Q): permet de créer, lire, mettre à jour et supprimer (CRUD) des métadonnées stockées dans le modèle de série chronologique de l’environnement. Elles peuvent être utilisées pour accéder aux instances, types et hiérarchies et les modifier.
- API TSQ (Time Series Query): permet la récupération des données de télémétrie ou d’événements enregistrées à partir du fournisseur source et permet des calculs et des agrégations performants sur les données à l’aide de fonctions scalaires et d’agrégation avancées.
Azure Time Series Insights Gen2 utilise un langage d’expression riche basé sur des chaînes, Time Series Expression (TSX), pour exprimer des calculs dans variables de série chronologique.
Vue d’ensemble des API Azure Time Series Insights Gen2
Les API principales suivantes sont prises en charge.
API d’environnement
- API Obtenir des environnements: renvoie la liste des environnements auxquels l’appelant est autorisé à accéder.
-
Get Environments Availability API: renvoie la répartition du nombre d'événements en fonction de leurs horodatages
$ts
. Cette API permet de déterminer s’il existe des événements dans l’environnement en retournant le nombre d’événements divisés en intervalles de temps, le cas échéant. - API Obtenir le Schéma d'Événement: renvoie les métadonnées du schéma d'événement pour une étendue de recherche donnée. Cette API permet de récupérer toutes les métadonnées et propriétés disponibles dans le schéma pour l’étendue de recherche donnée.
Séries temporelles Model-Query (TSM-Q) APIs
La plupart de ces API prennent en charge l’opération d’exécution par lots pour activer les opérations CRUD par lots sur plusieurs entités de modèle de série chronologique :
- API Paramètres du modèle: active GET et PATCH sur le type par défaut et le nom du modèle de l'environnement.
- API Types: permet le CRUD sur les types de séries temporelles et leurs variables associées.
- API Hiérarchies: active CRUD sur les hiérarchies Time Series et leurs chemins de champ associés.
- API Instances: active CRUD sur les instances Time Series et leurs champs d’instance associés. En outre, l’API Instances prend en charge les opérations suivantes :
API de requêtes de séries temporelles (TSQ)
Ces API sont disponibles dans les deux magasins (chaud et froid) dans notre solution de stockage multicouche.
l’API Get Events: active la requête et la récupération d’événements bruts et les horodatages d’événements associés au fur et à mesure qu’ils sont enregistrés dans Azure Time Series Insights Gen2 à partir du fournisseur source. Cette API permet la récupération d’événements bruts pour un ID de série chronologique et une étendue de recherche donnés. Cette API prend en charge la pagination pour récupérer le jeu de données de réponse complet pour l’entrée sélectionnée.
Important
Dans le cadre de la modifications à venir apportées aux règles d’aplatissement et d’échappement JSON, les tableaux seront stockés en tant que type de dynamique. Les propriétés de charge utile stockées comme ce type sont UNIQUEMENT accessibles via l’API Get Events.
API Get Series: permet la requête et la récupération des valeurs calculées ainsi que les horodatages des événements associés en appliquant des calculs définis par des variables sur des données brutes. Ces variables peuvent être définies dans le modèle de série chronologique ou fournies inline dans la requête. Cette API prend en charge la pagination pour récupérer le jeu de données de réponse complet pour l’entrée sélectionnée.
API Aggregate Series: active les requêtes et la récupération des valeurs agrégées et les horodatages des intervalles associés en appliquant des calculs définis par des variables sur des événements bruts. Ces variables peuvent être définies dans le modèle de série chronologique ou fournies inline dans la requête. Cette API prend en charge la pagination pour récupérer le jeu de données de réponse complet pour l’entrée sélectionnée.
Pour une étendue de recherche et un intervalle spécifiés, cette API retourne une réponse agrégée par intervalle par variable pour un ID Time Series. Le nombre d’intervalles dans le jeu de données de réponse est calculé en comptant les ticks d'époque (le nombre de millisecondes écoulées depuis l'époque Unix - 1er janvier 1970) et en divisant ces ticks par la taille d'intervalle spécifiée dans la requête.
Les horodatages retournés dans le jeu de réponses sont des limites d’intervalle gauche, et non ceux des événements échantillonnés de l’intervalle.
Sélection du type de magasin
Les API ci-dessus ne peuvent s’exécuter que sur l’un des deux types de stockage (froid ou chaud) dans un seul appel. Les paramètres d’URL de requête sont utilisés pour spécifier le type de magasin sur lequel la requête doit s’exécuter.
Si aucun paramètre n’est spécifié, la requête est exécutée sur le magasin froid, par défaut. Si une requête s’étend sur une plage de temps qui se chevauche à la fois dans un magasin froid et chaud, il est recommandé d’acheminer la requête vers le magasin froid pour une expérience optimale, car le magasin Chaud ne contiendra que des données partielles.
L'
Étapes suivantes
- En savoir plus sur les différentes variables qui peuvent être définies dans le modèle de série chronologique .
- En savoir plus sur la façon d’interroger des données à partir de l’explorateur Azure Time Series Insights.