Uw ontwikkelomgeving instellen voor het gebruik van Kusto-clientbibliotheken

Meer informatie over het instellen van uw omgeving voor het gebruik van Kusto-clientbibliotheken. U kunt deze bibliotheken gebruiken om apps te maken die verbinding maken met een cluster en query's uitvoeren of gegevens opnemen.

In dit artikel leert u hoe u clientbibliotheekpakketten installeert voor uw voorkeurstaal.

Vereisten

Selecteer de vereisten voor de programmeertaal die wordt gebruikt om uw app te maken.

Notitie

Kusto-clientbibliotheken zijn compatibel met JavaScript en TypeScript. Als u TypeScript-voorbeelden wilt converteren naar JavaScript, verwijdert u gewoon de typeaantekeningen die worden gebruikt voor variabelen, parameters en retourwaarden.

C#

Een of meer van de volgende .NET SDK-frameworks:

• .NET SDK 5.0 of hoger
• .NET Core 2.1 of hoger
• .NET Standard 2.1 of hoger
• .NET Framework 4.7.2 of hoger

Installatie controleren: voer in een opdrachtshell uit dotnet sdk check om te controleren of de geïnstalleerde versies voldoen aan de minimale vereisten.

Python

• Python 3.7 of hoger
  • Zorg ervoor dat het python uitvoerbare bestand zich in uw PATH
  • Installatie controleren: voer in een opdrachtshell uit python --version om te controleren of de versie 3.7 of hoger is

Typescript

• Knooppunt 16 of hoger gebouwd met ES6

  • Zorg ervoor dat het node uitvoerbare bestand zich in uw PATH
  • Installatie controleren: voer in een opdrachtshell uit node --version om te controleren of de versie 3.7 of hoger is

• Een Node.js-app of een web-app op basis van een browser, zoals een React-app.

• Voor browsergebaseerde web-apps:

  • Als uw app een aanmeldingservaring heeft, kunt u de bibliotheek @auzre/identiteit gebruiken om een autorisatietoken uit te geven en dit token te gebruiken withTokenProvider voor de Kusto-client:

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

  • Als uw app geen aanmeldingservaring heeft of als u liever de Kusto-clientbibliotheek gebruikt om verificatie te vragen, moet u een toepassingsregistratie instellen met de benodigde machtigingen:

    1. Maak een Microsoft Entra toepassingsregistratie.
    2. Selecteer op het tabblad Verificatiede optie + Een platform toevoegen. Selecteer vervolgens Toepassing met één pagina.
    3. Voer de gewenste omleidings-URI's in, selecteer de selectievakjes voor Toegangstokens en id-tokens en selecteer Configureren. Zie Desktop-app die web-API's aanroept voor meer informatie over omleidings-URI's.
    4. Configureer gedelegeerde machtigingen voor de toepassing.
    5. Ververleent de toepassing toegang tot uw Azure Data Explorer-database.
    6. Kopieer op het tabblad Overzicht de toepassings-id (client-id).

    In de voorbeelden in de volgende zelfstudies wordt de Kusto-clientbibliotheek gebruikt om verificatie te vragen.

    Notitie

    Als u deel uitmaakt van een organisatie, kunnen beperkingen op basis van organisatieconfiguraties verhinderen dat u zich kunt verifiëren. Vraag een organisatiebeheerder om toegang of probeer het opnieuw met een persoonlijk account.

Java

• JDK 8 of hoger
  • Zorg ervoor dat het java uitvoerbare bestand zich in uw PATH
  • Installatie controleren: voer in een opdrachtshell uit java -version om te controleren of versie 8 of hoger is
• Maven 3.6.3 of hoger
  • Zorg ervoor dat het mvn uitvoerbare bestand zich in uw PATH
  • Installatie controleren: voer in een opdrachtshell uit mvn -version om te controleren of versie 3.6.3 of hoger is

Het pakket installeren

In deze sectie wordt u begeleid bij het installeren van de Kusto-clientbibliotheek in uw omgeving.

De volgende tabel bevat de clientbibliotheken en de bijbehorende pakketnamen.

Bibliotheeknaam	Description
Kusto-gegevensbibliotheek	Biedt een client voor het maken van verbinding met clusters. Gebruik de clientbibliotheek om een query uit te voeren op gegevens of beheeropdrachten uit te voeren.
Kusto Ingest-bibliotheek	Biedt een client voor het opnemen van gegevens in clusters. Zie Gegevens opnemen in uw cluster voor meer informatie.

Voeg de Kusto-clientbibliotheken voor uw voorkeurstaal toe aan uw project of gebruik de pakketbeheerder die geschikt is voor uw taal om de clientbibliotheken te installeren.

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

Gebruik bij het maken van apps als volgt de maven-archetype-quickstart Maven-sjabloon voor het pakket.

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

Voeg vervolgens de volgende afhankelijkheden toe aan uw pom.xml, waarbij u de artefactversies vervangt door de nieuwste versie die beschikbaar is op Maven Central voor kusto-data en 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>

U moet ook de invoegtoepassing maven-compiler enexec-maven-plugin toevoegen aan uw pom.xml. Als ze nog niet bestaan, voegt u ze als volgt toe.

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

De Kusto SDK's bevatten voorbeeldtoepassingen voor snel starten. Deze toepassingen laten zien hoe u gegevens kunt verifiëren, beheren, opvragen en opnemen met behulp van de Kusto-clientbibliotheken. U kunt deze gebruiken als uitgangspunt voor uw eigen toepassing door de code te wijzigen of specifieke secties in uw project op te nemen.

C#

C#-snelstart-app

Python

Python-snelstart-app

Typescript

• snelstart-app voorNode.js
• Snelstart-app voor browser

Java

Java-snelstart-app

Meer informatie over het maken van apps die gebruikmaken van clientbibliotheken

De volgende artikelen helpen u bij het maken van apps die gebruikmaken van de Kusto-clientbibliotheken.

• Uw eerste app maken
• Een app maken om basisquery's uit te voeren
• Een app maken om beheeropdrachten uit te voeren
• Een app maken om gegevens op te halen met behulp van opname in de wachtrij

Gerelateerde inhoud

• KQL-snelzoekgids
• Voorbeeldwizard voor app-generator