Hello Kusto: Erstellen Ihrer ersten App

In diesem Artikel werden folgende Vorgehensweisen behandelt:

• Erstellen Ihrer ersten Client-App
• Verwenden der interaktiven Authentifizierung
• Führen Sie eine einfache Abfrage aus, die Hello Kusto!

Voraussetzungen

Richten Sie Ihre Entwicklungsumgebung für die Verwendung der Kusto-Clientbibliothek ein.

Erstellen der App

Erstellen Sie in Ihrer bevorzugten IDE oder dem Text-Editor ein Projekt oder eine Datei namens hello kusto unter Verwendung der konvention, die für Ihre bevorzugte Sprache geeignet ist. Fügen Sie dann den folgenden Code hinzu:

1. Fügen Sie die Kusto-Client- und Zeichenfolgen-Generator-Klassen hinzu.

   C#

   using Kusto.Data;
   using Kusto.Data.Net.Client;
   

   Python

   from azure.kusto.data import KustoClient, KustoConnectionStringBuilder
   

   Typescript

   import { Client as KustoClient, KustoConnectionStringBuilder } from "azure-kusto-data";
   import { InteractiveBrowserCredentialInBrowserOptions } from "@azure/identity";
   

   Hinweis

   Verwenden Sie InteractiveBrowserCredentialNodeOptions für Node.js Apps anstelle von InteractiveBrowserCredentialInBrowserOptions.

   Java

   import com.microsoft.azure.kusto.data.Client;
   import com.microsoft.azure.kusto.data.ClientFactory;
   import com.microsoft.azure.kusto.data.KustoOperationResult;
   import com.microsoft.azure.kusto.data.KustoResultSetTable;
   import com.microsoft.azure.kusto.data.auth.ConnectionStringBuilder;
   

2. Definieren Sie eine leere Funktion namens, main und rufen Sie sie auf.

   C#

   namespace HelloKusto {
     class HelloKusto {
       static void Main(string[] args) {
       }
     }
   }
   

   Python

   def main():
   
   if __name__ == "__main__":
     main()
   

   Typescript

   async function main()
   {
   }
   
   main();
   

   Java

   public class HelloKusto 
   {
     public static void main(String[] args) throws Exception {
       try {
       }
     }
   }
   

3. Erstellen Sie ein Verbindungszeichenfolge Builder-Objekt, das den Cluster-URI definiert und den Authentifizierungsmodus auf interaktiv festlegt. Weitere Informationen zum Cluster-URI finden Sie unter Kusto-Verbindungszeichenfolgen.

   C#

   var clusterUri = "https://help.kusto.windows.net/";
   var kcsb = new KustoConnectionStringBuilder(clusterUri).WithAadUserPromptAuthentication();
   

   Python

   cluster_uri = "https://help.kusto.windows.net"
   kcsb = KustoConnectionStringBuilder.with_interactive_login(cluster_uri)
   

   Typescript

   Die clientId und redirectUri stammen aus der Microsoft Entra App-Registrierung, die Sie im Abschnitt Voraussetzungen unter Einrichten Ihrer Entwicklungsumgebung erstellt haben.

   const clusterUri = "https://help.kusto.windows.net";
   const authOptions = {
     clientId: "5e39af3b-ba50-4255-b547-81abfb507c58",
     redirectUri: "http://localhost:5173",
   } as InteractiveBrowserCredentialInBrowserOptions;
   const kcsb = KustoConnectionStringBuilder.withUserPrompt(clusterUri, authOptions);
   

   Hinweis

   Verwenden Sie InteractiveBrowserCredentialNodeOptions für Node.js Apps anstelle von InteractiveBrowserCredentialInBrowserOptions.

   Java

   String clusterUri = "https://help.kusto.windows.net/";
   ConnectionStringBuilder kcsb = ConnectionStringBuilder.createWithUserPrompt(clusterUri);
   

   Hinweis

   Für die interaktive Authentifizierung benötigen Sie ein Microsoft-Konto oder eine Microsoft Entra Benutzeridentität. Ein Azure-Abonnement ist nicht erforderlich.

   In C# fordert der interaktive Authentifizierungsprozess den Benutzer möglicherweise nicht auf, wenn:

   • Der Benutzer ist bereits auf dem Gerät authentifiziert.
   • Es gibt einen Kusto. Explorer- oder Azure Date Explorer Web UI-Authentifizierung auf dem Gerät

4. Erstellen Sie ein Clientobjekt, das das Verbindungszeichenfolge Builder-Objekt verwendet, um eine Verbindung mit dem Cluster herzustellen.

   Hinweis

   Es wird dringend empfohlen, den Kusto-Client instance zwischenzuspeichern und wiederzuverwenden. Das häufige Erneute Erstellen von Kusto-Clients kann zu Leistungseinbußen in Ihrer Anwendung und zu einer erhöhten Auslastung Ihres Clusters führen.

   C#

   using (var kustoClient = KustoClientFactory.CreateCslQueryProvider(kcsb)) {
   }
   

   Python

   with KustoClient(kcsb) as kusto_client:
   

   Typescript

   const kustoClient = new KustoClient(kcsb);
   

   Java

   try (Client kustoClient = ClientFactory.createClient(kcsb)) {
   }
   

5. Definieren Sie die auszuführende Datenbank und Abfrage. Die Abfrage gibt Hello Kusto! in einer Spalte mit dem Namen Willkommen aus.

   C#

   var database = "Samples";
   var query = "print Welcome='Hello Kusto!'";
   

   Python

   database = "Samples"
   query = "print Welcome='Hello Kusto!'"
   

   Typescript

   const database = "Samples";
   const query = "print Welcome='Hello Kusto!'";
   

   Java

   String database = "Samples";
   String query = "print Welcome='Hello Kusto!'";
   

6. Führen Sie die Abfrage aus, und drucken Sie das Ergebnis.

   C#

   using (var response = kustoClient.ExecuteQuery(database, query, null)) {
     response.Read();
     int columnNo = response.GetOrdinal("Welcome");
     Console.WriteLine(response.GetString(columnNo));
   }
   

   Python

   response = kusto_client.execute(database, query)
   
   print(response.primary_results[0][0]["Welcome"])
   

   Typescript

   const response = await kustoClient.execute(database, query);
   
   console.log(response.primaryResults[0][0]["Welcome"].toString());
   

   Java

   KustoOperationResult response = kustoClient.execute(database, query);
   
   KustoResultSetTable primary_results = response.getPrimaryResults();
   primary_results.next();
   System.out.println(primary_results.getString("Welcome"));
   

   Hinweis

   Die Abfrageausgabe wird in der Antwort als Objekt zurückgegeben, das eine oder mehrere Tabellen enthält, die aus weiteren Zeilen und Spalten bestehen. Das Format des Objekts hängt von der Clientbibliothekssprache ab.

   Die Print kusto-Abfrage gibt eine einzelne Tabelle mit einer Zeile und Spalte zurück.

   C#

   Die Antwort ist ein DataReader-Objekt . Sie können wie folgt auf das Ergebnis verweisen:

   • Verwenden der Read() -Methode zum Lesen der ersten Zeile
   • Verwenden Sie die GetString()-Methode, um den Wert der ersten Spalte abzurufen.

   Python/TypeScript

   Die Antwort im JSON-Objekt der primären Ergebnisse. Das -Objekt enthält ein Array von Tabellen, das wiederum ein Array von Zeilen enthält. Jede Zeile enthält Daten, die in einem Wörterbuch mit Spalten organisiert sind. Sie können wie folgt auf das Ergebnis verweisen:

   • Der erste Arrayindex [0] verweist auf die erste Tabelle.
   • Der zweite Arrayindex [0] verweist auf die erste Zeile.
   • Der Wörterbuchschlüssel ["Welcome"] verweist auf die Spalte Willkommen.

   Java

   Die Antwort ist ein KustoOperationResult-Objekt. Sie können wie folgt auf das Ergebnis verweisen:

   • Verwenden Der methode getPrimaryResults() zum Abrufen der primären Ergebnistabelle
   • die next() -Methode zum Lesen der ersten Zeile
   • die getString()-Methode zum Abrufen des Werts der ersten Spalte

Der vollständige Code sollte wie folgt aussehen:

C#

using Kusto.Data;
using Kusto.Data.Net.Client;

namespace HelloKusto {
  class HelloKusto {
    static void Main(string[] args) {
      string clusterUri = "https://help.kusto.windows.net/";
      var kcsb = new KustoConnectionStringBuilder(clusterUri).WithAadUserPromptAuthentication();
    
      using (var kustoClient = KustoClientFactory.CreateCslQueryProvider(kcsb)) {
        string database = "Samples";
        string query = "print Welcome='Hello Kusto!'";

        using (var response = kustoClient.ExecuteQuery(database, query, null)) {
          response.Read();
          int columnNo = response.GetOrdinal("Welcome");
          Console.WriteLine(response.GetString(columnNo));
        }
      }
    }
  }
}

Python

from azure.kusto.data import KustoClient, KustoConnectionStringBuilder

def main():
  cluster_uri = "https://help.kusto.windows.net"
  kcsb = KustoConnectionStringBuilder.with_interactive_login(cluster_uri)

  with KustoClient(kcsb) as kusto_client:

    database = "Samples"
    query = "print Welcome='Hello Kusto!'"
    response = kusto_client.execute(database, query)

    print(response.primary_results[0][0]["Welcome"])

if __name__ == "__main__":
  main()

Typescript

import { Client as KustoClient, KustoConnectionStringBuilder } from "azure-kusto-data/";
import { InteractiveBrowserCredentialInBrowserOptions } from "@azure/identity";

async function main()
{
  const clusterUri = "https://help.kusto.windows.net";
  const authOptions = {
    clientId: "5e39af3b-ba50-4255-b547-81abfb507c58",
    redirectUri: "http://localhost:5173",
  } as InteractiveBrowserCredentialInBrowserOptions;
  const kcsb = KustoConnectionStringBuilder.withUserPrompt(clusterUri, authOptions);
  const kustoClient = new KustoClient(kcsb);

  const database = "Samples";
  const query = "print Welcome='Hello Kusto!'";
  const response = await kustoClient.execute(database, query);

  console.log(response.primaryResults[0][0]["Welcome"].toString());
}

main();

Hinweis

Verwenden Sie InteractiveBrowserCredentialNodeOptions für Node.js Apps anstelle von InteractiveBrowserCredentialInBrowserOptions.

Java

import com.microsoft.azure.kusto.data.Client;
import com.microsoft.azure.kusto.data.ClientFactory;
import com.microsoft.azure.kusto.data.KustoOperationResult;
import com.microsoft.azure.kusto.data.KustoResultSetTable;
import com.microsoft.azure.kusto.data.auth.ConnectionStringBuilder;

public class HelloKusto {
  public static void main(String[] args) throws Exception {
    try {
      String clusterUri = "https://help.kusto.windows.net/";
      ConnectionStringBuilder kcsb = ConnectionStringBuilder.createWithUserPrompt(clusterUri);

      try (Client kustoClient = ClientFactory.createClient(kcsb)) {
        String database = "Samples";
        String query = "print Welcome='Hello Kusto!'";
        KustoOperationResult response = kustoClient.execute(database, query);

        KustoResultSetTable primaryResults = response.getPrimaryResults();
        primaryResults.next();
        System.out.println(primaryResults.getString("Welcome"));
      }
    }
  }
}

Ausführen der App

Verwenden Sie in einer Befehlsshell den folgenden Befehl, um Ihre App auszuführen:

C#

# Change directory to the folder that contains the hello world project
dotnet run .

Python

python hello_kusto.py

Typescript

In einer Node.js Umgebung:

node hello-kusto.js

Verwenden Sie in einer Browserumgebung den entsprechenden Befehl, um Ihre App auszuführen. Beispiel für Vite-React:

npm run dev

Hinweis

Öffnen Sie in einer Browserumgebung die Konsole der Entwicklertools , um die Ausgabe anzuzeigen.

Java

mvn install exec:java -Dexec.mainClass="<groupId>.HelloKusto"

Es sollte ein Ergebnis ähnlich dem folgenden angezeigt werden:

Hello Kusto!

Nächster Schritt

Erstellen einer App zum Ausführen grundlegender Abfragen