Einrichten Ihrer Entwicklungsumgebung für die Verwendung von Kusto-Clientbibliotheken

Erfahren Sie, wie Sie Ihre Umgebung für die Verwendung von Kusto-Clientbibliotheken einrichten. Sie können diese Bibliotheken verwenden, um Apps zu erstellen, die eine Verbindung mit einem Cluster herstellen und Abfragen ausführen oder Daten erfassen.

In diesem Artikel erfahren Sie, wie Sie Clientbibliothekspakete für Ihre bevorzugte Sprache installieren.

Voraussetzungen

Wählen Sie die Voraussetzungen für die Programmiersprache aus, die zum Erstellen Ihrer App verwendet wird.

Hinweis

Kusto-Clientbibliotheken sind mit JavaScript und TypeScript kompatibel. Um TypeScript-Beispiele in JavaScript zu konvertieren, entfernen Sie einfach die Typanmerkungen, die für Variablen, Parameter und Rückgabewerte verwendet werden.

C#

Mindestens eines der folgenden .NET SDK-Frameworks:

• .NET SDK 5.0 oder höher
• .NET Core 2.1 oder höher
• .NET Standard 2.1 oder höher
• .NET Framework 4.7.2 oder höher

Installation überprüfen: Führen Sie in einer Befehlsshell aus dotnet sdk check , um zu überprüfen, ob die installierten Versionen die Mindestanforderungen erfüllen.

Python

• Python 3.7 oder höher
  • Stellen Sie sicher, dass die python ausführbare Datei in Ihrem PATH
  • Überprüfen der Installation: Führen Sie in einer Befehlsshell aus python --version , um zu überprüfen, ob die Version 3.7 oder höher ist.

Typescript

• Knoten 16 oder höher , erstellt mit ES6

  • Stellen Sie sicher, dass die node ausführbare Datei in Ihrem PATH
  • Überprüfen der Installation: Führen Sie in einer Befehlsshell aus node --version , um zu überprüfen, ob die Version 3.7 oder höher ist.

• Eine Node.js-App oder eine browserbasierte Web-App, z. B. eine React-App.

• Für browserbasierte Web-Apps:

  • Wenn Ihre App über eine Anmeldeoberfläche verfügt, können Sie die @auzre-/Identitätsbibliothek verwenden, um ein Autorisierungstoken auszustellen und withTokenProvider dieses Token an den Kusto-Client zu übertragen:

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

  • Wenn Ihre App nicht über eine Anmeldeoberfläche verfügt oder Sie die Kusto-Clientbibliothek verwenden möchten, um die Authentifizierung aufzufordern, müssen Sie eine Anwendungsregistrierung mit den erforderlichen Berechtigungen einrichten:

    1. Erstellen Sie eine Microsoft Entra Anwendungsregistrierung.
    2. Wählen Sie auf der Registerkarte Authentifizierungdie Option + Plattform hinzufügen aus. Wählen Sie dann Single-page application (Einzelseitenanwendung) aus.
    3. Geben Sie die gewünschten Umleitungs-URIs ein, aktivieren Sie die Felder für Zugriffstoken und ID-Token, und wählen Sie Konfigurieren aus. Weitere Informationen zu Umleitungs-URIs finden Sie unter Desktop-App, die Web-APIs aufruft.
    4. Konfigurieren Sie delegierte Berechtigungen für die Anwendung.
    5. Gewähren Sie der Anwendung Zugriff auf Ihre Azure Data Explorer-Datenbank.
    6. Kopieren Sie auf der Registerkarte Übersicht die Anwendungs-ID (Client).

    In den Beispielen in den folgenden Tutorials wird die Kusto-Clientbibliothek verwendet, um die Authentifizierung aufzufordern.

    Hinweis

    Wenn Sie zu einer organization gehören, können Einschränkungen, die auf organization Konfigurationen basieren, sie daran hindern, sich zu authentifizieren. Bitten Sie einen organization Administrator um Zugriff, oder versuchen Sie es erneut mit einem persönliches Konto.

Java

• JDK 8 oder höher
  • Stellen Sie sicher, dass die java ausführbare Datei in Ihrem PATH
  • Überprüfen der Installation: Führen Sie in einer Befehlsshell aus java -version , um zu überprüfen, ob die Version 8 oder höher ist.
• Maven 3.6.3 oder höher
  • Stellen Sie sicher, dass die mvn ausführbare Datei in Ihrem PATH
  • Überprüfen der Installation: Führen Sie in einer Befehlsshell aus mvn -version , um zu überprüfen, ob die Version 3.6.3 oder höher ist.

Installieren des Pakets

In diesem Abschnitt erfahren Sie, wie Sie die Kusto-Clientbibliothek in Ihrer Umgebung installieren.

In der folgenden Tabelle sind die Clientbibliotheken und die entsprechenden Paketnamen aufgeführt.

Name der Bibliothek	BESCHREIBUNG
Kusto-Datenbibliothek	Stellt einen Client zum Herstellen einer Verbindung mit Clustern bereit. Verwenden Sie die Clientbibliothek, um Daten abzufragen oder Verwaltungsbefehle auszuführen.
Kusto-Erfassungsbibliothek	Stellt einen Client zum Erfassen von Daten in Clustern bereit. Weitere Informationen finden Sie unter Erfassen von Daten in Ihrem Cluster.

Fügen Sie ihrem Projekt die Kusto-Clientbibliotheken für Ihre bevorzugte Sprache hinzu, oder verwenden Sie den für Ihre Sprache geeigneten Paket-Manager, um die Clientbibliotheken zu installieren.

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

Verwenden Sie beim Erstellen von Apps wie folgt die Maven-Maven-Vorlage maven-archetype-quickstart für das Paket.

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

Fügen Sie dann den pom.xml die folgenden Abhängigkeiten hinzu, und ersetzen Sie dabei die Artefaktversionen durch die neuesten verfügbaren Versionen in Maven Central für kusto-data und 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>

Sie müssen auch die Plug-Ins maven-compiler-plugin und exec-maven-plugin in Ihrem pom.xml hinzufügen. Wenn sie noch nicht vorhanden sind, fügen Sie sie wie folgt hinzu.

<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>

Die Kusto-SDKs enthalten Schnellstartbeispielanwendungen. Diese Anwendungen zeigen, wie Sie Daten mithilfe der Kusto-Clientbibliotheken authentifizieren, verwalten, abfragen und erfassen. Sie können sie als Ausgangspunkt für Ihre eigene Anwendung verwenden, indem Sie den Code ändern oder bestimmte Abschnitte in Ihr Projekt integrieren.

C#

C#-Schnellstart-App

Python

Python-Schnellstart-App

Typescript

• Node.js-Schnellstart-App
• Browser-Schnellstart-App

Java

Java-Schnellstart-App

Erfahren Sie, wie Sie Apps erstellen, die Clientbibliotheken verwenden.

Die folgenden Artikel führen Sie durch das Erstellen von Apps, die die Kusto-Clientbibliotheken verwenden.

• Erstellen der ersten App
• Erstellen einer App zum Ausführen grundlegender Abfragen
• Erstellen einer App zum Ausführen von Verwaltungsbefehlen
• Erstellen einer App zum Abrufen von Daten mithilfe der Erfassung in die Warteschlange

Verwandte Inhalte

• KQL-Kurzübersicht
• Assistent für den Beispiel-App-Generator