Gilt für: ✅Microsoft Fabric✅Azure Data Explorer
Richten Sie Ihre Umgebung für die Verwendung von Kusto-Clientbibliotheken ein. Mit diesen Bibliotheken können Sie Apps erstellen, die eine Verbindung mit einem Cluster herstellen, Abfragen ausführen oder Daten aufnehmen.
In diesem Artikel wird erläutert, 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 die Typanmerkungen, die für Variablen, Parameter und Rückgabewerte verwendet werden.
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 aus dotnet sdk check , um zu bestätigen, dass die installierten Versionen die Mindestanforderungen erfüllen.
-
Python 3.7 oder höher
- Stellen Sie sicher, dass sich die
python ausführbare Datei in Ihrem PATH
- Überprüfen Sie die Installation: Führen Sie in einer Befehlsshell aus
python --version , um zu bestätigen, dass die Version 3.7 oder höher ist.
Knoten 16 oder höher erstellt mit ES6
- Stellen Sie sicher, dass sich die ausführbare Datei
node in PATH befindet
- Überprüfen Sie die Installation: Führen Sie in einer Befehlsshell aus
node --version , um zu bestätigen, dass 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 Anmeldeerfahrung verfügt, verwenden Sie die @auzre/Identitätsbibliothek, um ein Autorisierungstoken auszustellen und withTokenProvider 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:
-
Erstellen einer Microsoft Entra-Anwendungsregistrierung
- Wählen Sie auf der Registerkarte Authentifizierung+ Plattform hinzufügen aus. Wählen Sie dann Single-Page-Webanwendung aus.
- 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. Erfahren Sie mehr über Umleitungs-URIs in der Desktop-App, die Web-APIs aufruft.
-
Konfigurieren delegierter Berechtigungen für die Anwendung.
-
Gewähren Sie der Anwendung Zugriff auf Ihre Datenbank.
- 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.
- JDK 8 oder höher
- Stellen Sie sicher, dass sich die
java ausführbare Datei in Ihrem PATH
- Überprüfen Sie die Installation: Führen Sie in einer Befehlsshell aus
java -version , um zu bestätigen, dass 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 ihrem Projekt die Kusto-Clientbibliotheken für Ihre bevorzugte Sprache hinzu. Verwenden Sie den Paket-Manager, der für Ihre Sprache geeignet ist, um die Clientbibliotheken zu installieren.
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
Verwenden Sie die Maven-Vorlage maven-archetype-quickstart, um Apps wie folgt zu erstellen.
mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId==my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false
Fügen Sie dem pom.xml die folgenden Abhängigkeiten hinzu. Ersetzen Sie die Artefakt-Versionen 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>
Fügen Sie das maven-compiler-plugin und exec-maven-plugin Plugins zu Ihrem pom.xmlhinzu. Wenn sie 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 Schnellstart-Beispielanwendungen, die zeigen, wie Sie Daten mithilfe der Kusto-Clientbibliotheken authentifizieren, verwalten, abfragen und aufnehmen können. Verwenden Sie sie als Ausgangspunkt für Ihre Anwendung, indem Sie den Code ändern oder bestimmte Abschnitte in Ihr Projekt integrieren.
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.
Verwandte Inhalte