Configurer votre environnement de développement pour utiliser des bibliothèques clientes Kusto

Un ou plusieurs des frameworks sdk .NET suivants :

• Sdk .NET 5.0 ou version ultérieure
• .NET Core 2.1 ou version ultérieure
• .NET Standard 2.1 ou version ultérieure
• .NET Framework 4.7.2 ou version ultérieure

Vérifier l’installation : dans un interpréteur de commandes, exécutez dotnet sdk check pour vérifier que les versions installées répondent à la configuration minimale requise.

• Python 3.7 ou version ultérieure
  • Vérifiez que l’exécutable python se trouve dans votre PATH
  • Vérifier l’installation : dans un interpréteur de commandes, exécutez python --version pour vérifier que la version est 3.7 ou ultérieure.

• Nœud 16 ou version ultérieure généré avec ES6

  • Vérifiez que l’exécutable node se trouve dans votre PATH
  • Vérifier l’installation : dans un interpréteur de commandes, exécutez node --version pour vérifier que la version est 3.7 ou ultérieure.

• Une application Node.js ou une application web basée sur un navigateur, telle qu’une application React.

• Pour les applications web basées sur un navigateur :

  • Si votre application comporte une expérience de connexion, utilisez la bibliothèque @auzre/identité pour émettre un jeton d’autorisation et utilisez-le withTokenProvider pour transmettre ce jeton au client Kusto :

    const tokenProvider =  () => Promise.resolve("someToken")
    KustoConnectionStringBuilder.withTokenProvider(clusterUri, tokenProvider)
    

  • Si votre application n’a pas d’expérience de connexion ou si vous préférez utiliser la bibliothèque cliente Kusto pour inviter l’authentification, vous devez configurer une inscription d’application avec les autorisations nécessaires :

    1. Créer une inscription d’application Microsoft Entra
    2. Dans l’onglet Authentification , sélectionnez + Ajouter une plateforme. Ensuite, sélectionnez l’application monopage.
    3. Entrez les URI de redirection souhaités, sélectionnez les zones pour les jetons d’accès et les jetonsd’ID, puis sélectionnez Configurer. En savoir plus sur les URI de redirection dans l’application de bureau qui appelle des API web.
    4. Configurez les autorisations déléguées pour l’application.
    5. Accordez à l’application l’accès à votre base de données.
    6. Dans l’onglet Vue d’ensemble, copiez l’ID d’application (client).

  Les exemples dans les didacticiels suivants utilisent la bibliothèque cliente Kusto pour inviter l’authentification.

  Note

  Si vous appartenez à une organisation, les restrictions basées sur les configurations de l’organisation peuvent vous empêcher d’authentifier. Demandez l’accès à partir d’un administrateur d’organisation ou réessayez sur un compte personnel.

• JDK 8 ou version ultérieure
  • Vérifiez que l’exécutable java se trouve dans votre PATH
  • Vérifier l’installation : dans un interpréteur de commandes, exécutez java -version pour vérifier que la version est 8 ou ultérieure.
• Maven 3.6.3 ou version ultérieure
  • Vérifiez que l’exécutable mvn se trouve dans votre PATH
  • Vérifier l’installation : dans un interpréteur de commandes, exécutez mvn -version pour vérifier que la version est 3.6.3 ou ultérieure

dotnet add package Microsoft.Azure.Kusto.Data --version 11.2.2
dotnet add package Microsoft.Azure.Kusto.Ingest --version 11.2.2

python -m pip install azure-kusto-data
python -m pip install azure-kusto-ingest

npm install azure-kusto-data
npm install azure-kusto-ingest

Utilisez le modèle Maven-archetype-quickstart Maven pour créer des applications, comme suit.

 mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId==my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

Ajoutez les dépendances suivantes à votre pom.xml. Remplacez les versions d’artefact par la dernière version disponible sur Maven Central pour kusto-data et kusto-ingest.

<dependency>
  <groupId>com.microsoft.azure.kusto</groupId>
  <artifactId>kusto-data</artifactId>
  <version>5.0.0</version>
</dependency>
<dependency>
  <groupId>com.microsoft.azure.kusto</groupId>
  <artifactId>kusto-ingest</artifactId>
  <version>5.0.0</version>
</dependency>

Ajoutez les plug-ins maven-compiler-plugin et exec-maven-plugin à votre pom.xml. S’ils n’existent pas, ajoutez-les comme suit.

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>${maven-compiler-plugin.version}</version>
  <configuration>
    <source>${java.version}</source>
    <target>${java.version}</target>
  </configuration>
</plugin>
<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.1.0</version>
</plugin>

Application de démarrage rapide C#

Application de démarrage rapide Python

• application de démarrage rapideNode.js
• Application de démarrage rapide du navigateur

Application de démarrage rapide Java