Interroger des données à partir d’un environnement Azure Time Series Insights Gen1 en utilisant C Sharp

Remarque

Le service Time Series Insights va être mis hors service le 7 juillet 2024. Prévoyez de migrer les environnements existants vers des solutions alternatives dès que possible. Pour plus d’informations sur la dépréciation et la migration, consultez notre documentation.

Attention

Il s’agit d’un article Gen1.

Cet exemple de code C# montre comment utiliser les API de requête Gen1 pour interroger des données à partir d’environnements Azure Time Series Insights Gen1.

Conseil

Consultez des exemples de code C# Gen1 à l’adresse https://github.com/Azure-Samples/Azure-Time-Series-Insights.

Résumé

L’exemple de code ci-dessous illustre les fonctionnalités suivantes :

• Comment acquérir un jeton d’accès via Microsoft Entra ID à l’aide de Microsoft.IdentityModel.Clients.ActiveDirectory.

• Comment passer ce jeton d’accès acquis dans l’en-tête Authorization des requêtes ultérieures d’API de requête.

• L’exemple appelle chacune des API de requête Gen1, illustrant la façon dont les requêtes HTTP sont adressées aux API :

  • API Get Environments pour retourner les environnements auxquels l’utilisateur a accès
  • API Get Environment Availability
  • API Get Environment Metadata pour récupérer les métadonnées d’environnement
  • API Get Environments Events
  • API Get Environment Aggregates

• Comment interagir avec les API de requête Gen1 à l’aide de WSS pour envoyer un message aux API :

  • API Get Environment Events Streamed
  • API Get Environment Aggregates Streamed

Composants requis et configuration

Effectuez les étapes suivantes avant de compiler et d'exécuter l’exemple de code :

1. Approvisionnez un environnement Azure Time Series Insights Gen1.
2. Configurez votre environnement Azure Time Series Insights pour Microsoft Entra ID comme décrit dans Authentification et autorisation.
3. Installez les dépendances de projet nécessaires.
4. Modifiez l’exemple de code ci-dessous en remplaçant chaque espace réservé #DUMMY# par l’identificateur d’environnement qui convient.
5. Exécutez le code dans Visual Studio.

Dépendances du projet

Il est recommandé d’utiliser la version la plus récente de Visual Studio :

• Visual Studio 2019 - Version 16.4.2+

L’exemple de code comporte deux dépendances obligatoires :

• Microsoft.IdentityModel.Clients.ActiveDirectory, package 3.13.9.
• Newtonsoft.Json, package 9.0.1.

Téléchargez les packages dans Visual Studio 2019 en sélectionnant l’option Générer>Générer la solution.

Vous pouvez également ajouter les packages à l’aide de NuGet 2.12+ :

• dotnet add package Newtonsoft.Json --version 9.0.1
• dotnet add package Microsoft.IdentityModel.Clients.ActiveDirectory --version 3.13.9

Exemple de code C#

Pour accéder à l’exemple de code C#, reportez-vous au dépôt Azure Time Series Insights].

Étapes suivantes

• Pour en savoir plus sur l’interrogation, consultez les informations de référence sur l’API de requête.

• Découvrez comment connecter une application JavaScript avec le SDK client à Time Series Insights. Azure-Samples/Azure-Time-Series-Insights/gen1-sample/csharp-tsi-gen1-sample/Program.cs