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

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer

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

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.

Anmerkung

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#

Eines oder mehrere 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

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

Python

• Python 3.7 oder höher
  • Stellen Sie sicher, dass sich die ausführbare Datei python in PATH befindet
  • Überprüfen der Installation: Führen Sie in einer Befehlsshell python --version aus, 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 sich die ausführbare Datei node in PATH befindet
  • Überprüfen der Installation: Führen Sie in einer Befehlsshell node --version aus, 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 verwenden, um dieses Token dem Kusto-Client zu übergeben:

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

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

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

    Die Beispiele in den folgenden Tutorials verwenden die Kusto-Clientbibliothek, um die Authentifizierung zu initiieren.

    Anmerkung

    Wenn Sie zu einer Organisation gehören, können Einschränkungen, die auf Organisationskonfigurationen basieren, verhindern, dass Sie authentifiziert werden. Bitten Sie um Zugriff von einem Organisationsadministrator, oder versuchen Sie es erneut mit einem persönlichen Konto.

Java

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

Installiere das Paket

Dieser Abschnitt führt Sie durch die Installation der Kusto-Clientbibliothek in Ihrer Umgebung.

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

Bibliotheksname	Beschreibung
Kusto-Datenbibliothek	Stellt einen Client zum Herstellen einer Verbindung mit Clustern bereit. Verwenden Sie die Clientbibliothek, um Daten abzufragen oder führen Sie Verwaltungsbefehle aus.
Kusto Ingest-Bibliothek	Stellt einen Client zur Erfassung von Daten in Cluster bereit. Weitere Informationen finden Sie unter Übersicht über Kusto Ingest-Bibliothek für Ihren Cluster.

Fügen Sie die Kusto-Clientbibliotheken für Ihre bevorzugte Sprache zu Ihrem Projekt hinzu, oder verwenden Sie den Paket-Manager, der für Ihre Sprache geeignet ist, 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 die Maven-Vorlage maven-archetype-quickstart für das Paket wie folgt.

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

Fügen Sie dann die folgenden Abhängigkeiten zu Ihrem pom.xml hinzu und ersetzen Sie die Artefaktversionen durch die neuesten verfügbaren Versionen auf 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 Plugins 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 Beispielanwendungen für den Schnellstart. Diese Anwendungen zeigen, wie Sie Daten mithilfe der Kusto-Clientbibliotheken authentifizieren, verwalten, abfragen und aufnehmen können. 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-
• App für Browser-Schnellstart

Java

Java-Schnellstart-App-

Erfahren Sie, wie Sie Apps erstellen, die Clientbibliotheken verwenden

In den folgenden Artikeln werden Sie durch das Erstellen von Apps geführt, die die Kusto-Clientbibliotheken verwenden.

• Erstellen Sie Ihre erste App
• App sichern
• Erstellen einer App zum Ausführen grundlegender Abfragen
• Erstellen einer App zum Ausführen von Verwaltungsbefehlen
• Erstellen einer App zum Abrufen von Daten mithilfe einer in die Warteschlange eingereihten Datenerfassung

Verwandte Inhalte

• KQL-Kurzübersicht

• Assistent für den Generator von Beispiel-Apps