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

Découvrez comment configurer votre environnement pour utiliser les bibliothèques clientes Kusto. Vous pouvez utiliser ces bibliothèques pour créer des applications qui se connectent à un cluster et exécutent des requêtes ou ingèrent des données.

Dans cet article, vous allez apprendre à installer des packages de bibliothèque cliente pour votre langue préférée.

Prérequis

Sélectionnez les prérequis pour le langage de programmation utilisé pour créer votre application.

Notes

Les bibliothèques clientes Kusto sont compatibles avec JavaScript et TypeScript. Pour convertir des exemples TypeScript en JavaScript, supprimez simplement les annotations de type utilisées pour les variables, les paramètres et les valeurs de retour.

C#

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 case activée que les versions installées répondent à la configuration minimale requise.

Python

• 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 case activée que la version est 3.7 ou ultérieure

Typescript

• 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 case activée 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 dispose d’une expérience de connexion, vous pouvez utiliser la bibliothèque d’identités/@auzre pour émettre un jeton d’autorisation et utiliser withTokenProvider pour fournir 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 demander l’authentification, vous devez configurer une inscription d’application avec les autorisations nécessaires :

    1. Créez une inscription d’application Microsoft Entra.
    2. Sous l’onglet Authentification , sélectionnez + Ajouter une plateforme. Ensuite, sélectionnez Application monopage.
    3. Entrez les URI de redirection souhaités, sélectionnez les zones Jetons d’accès et jetons d’ID, puis sélectionnez Configurer. Pour plus d’informations sur les URI de redirection, consultez 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 Azure Data Explorer.
    6. Sous l’onglet Vue d’ensemble, copiez l’ID d’application (client).

    Les exemples des didacticiels suivants utilisent la bibliothèque de client Kusto pour demander l’authentification.

    Notes

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

Java

• 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 case activée 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 case activée que la version est 3.6.3 ou ultérieure

Installer le package

Cette section vous guide tout au long de l’installation de la bibliothèque cliente Kusto dans votre environnement.

Le tableau suivant répertorie les bibliothèques clientes et les noms de package correspondants.

Nom de la bibliothèque	Description
Bibliothèque de données Kusto	Fournit un client pour la connexion aux clusters. Utilisez la bibliothèque cliente pour interroger des données ou exécuter des commandes de gestion.
Bibliothèque Kusto Ingest	Fournit un client pour ingérer des données dans des clusters. Pour plus d’informations, consultez Ingérer des données dans votre cluster.

Ajoutez les bibliothèques clientes Kusto pour votre langue préférée à votre projet, ou utilisez le gestionnaire de package approprié pour votre langue pour installer les bibliothèques clientes.

C#

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

Python

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

Typescript

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

Java

Lors de la création d’applications, utilisez le modèle Maven-archetype-quickstart Maven pour le package, comme suit.

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

Ajoutez ensuite les dépendances suivantes à votre pom.xml, en remplaçant les versions d’artefact par les dernières versions disponibles 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>

Vous devez également ajouter les plug-ins maven-compiler-plugin et exec-maven-plugin dans votre pom.xml. S’ils n’existent pas déjà, 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>

Les kits SDK Kusto contiennent des exemples d’applications de démarrage rapide. Ces applications montrent comment authentifier, administrer, interroger et ingérer des données à l’aide des bibliothèques clientes Kusto. Vous pouvez les utiliser comme point de départ pour votre propre application en modifiant le code ou en incorporant des sections spécifiques dans votre projet.

C#

Application de démarrage rapide C#

Python

Application de démarrage rapide Python

Typescript

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

Java

Application de démarrage rapide Java

Découvrez comment créer des applications qui utilisent des bibliothèques clientes

Les articles suivants vous guident tout au long de la création d’applications qui utilisent les bibliothèques clientes Kusto.

• Créer votre première application
• Créer une application pour exécuter des requêtes de base
• Créer une application pour exécuter des commandes de gestion
• Créer une application pour obtenir des données à l’aide de l’ingestion en file d’attente

Contenu connexe

• Aide-mémoire sur KQL
• Assistant Générateur d’échantillon d’application