Konfigurera utvecklingsmiljön så att kusto-klientbibliotek används

Lär dig hur du konfigurerar din miljö för att använda Kusto-klientbibliotek. Du kan använda de här biblioteken för att skapa appar som ansluter till ett kluster och köra frågor eller mata in data.

I den här artikeln får du lära dig hur du installerar klientbibliotekspaket för önskat språk.

Förutsättningar

Välj förutsättningar för programmeringsspråket som används för att skapa din app.

Anteckning

Kusto-klientbibliotek är kompatibla med JavaScript och TypeScript. Om du vill konvertera TypeScript-exempel till JavaScript tar du helt enkelt bort de typanteckningar som används för variabler, parametrar och returvärden.

C#

Ett eller flera av följande .NET SDK-ramverk:

• .NET SDK 5.0 eller senare
• .NET Core 2.1 eller senare
• .NET Standard 2.1 eller senare
• .NET Framework 4.7.2 eller senare

Verifiera installationen: Kör i ett kommandogränssnitt dotnet sdk check för att kontrollera att de installerade versionerna uppfyller minimikraven.

Python

• Python 3.7 eller senare
  • Kontrollera att den python körbara filen finns i din PATH
  • Verifiera installationen: Kör python --version i ett kommandogränssnitt för att kontrollera att versionen är 3.7 eller senare

Maskin

• Nod 16 eller senare skapad med ES6

  • Kontrollera att den node körbara filen finns i din PATH
  • Verifiera installationen: Kör node --version i ett kommandogränssnitt för att kontrollera att versionen är 3.7 eller senare

• En Node.js app eller en webbläsarbaserad webbapp, till exempel en React app.

• För webbläsarbaserade webbappar:

  • Om din app har en inloggningsupplevelse kan du använda @auzre/identitetsbiblioteket för att utfärda en auktoriseringstoken och använda withTokenProvider för att mata in denna token till Kusto-klienten:

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

  • Om din app inte har någon inloggningsupplevelse, eller om du föredrar att använda Kusto-klientbiblioteket för att fråga efter autentisering, måste du konfigurera en programregistrering med nödvändiga behörigheter:

    1. Skapa en Microsoft Entra programregistrering.
    2. På fliken Autentisering väljer du + Lägg till en plattform. Välj sedan Ensidesprogram.
    3. Ange önskade omdirigerings-URI:er, markera rutorna för Åtkomsttoken och ID-token och välj Konfigurera. Mer information om omdirigerings-URI:er finns i Skrivbordsapp som anropar webb-API:er.
    4. Konfigurera delegerade behörigheter för programmet.
    5. Ge programmet åtkomst till din Azure Data Explorer-databas.
    6. På fliken Översikt kopierar du program-ID:t (klient).

    Exemplen i följande självstudier använder Kusto-klientbiblioteket för att fråga efter autentisering.

    Anteckning

    Om du tillhör en organisation kan begränsningar som baseras på organisationskonfigurationer hindra dig från att autentisera. Be om åtkomst från en organisationsadministratör eller försök igen med ett personligt konto.

Java

• JDK 8 eller senare
  • Kontrollera att den java körbara filen finns i din PATH
  • Verifiera installationen: Kör java -version i ett kommandogränssnitt för att kontrollera att versionen är 8 eller senare
• Maven 3.6.3 eller senare
  • Kontrollera att den mvn körbara filen finns i din PATH
  • Verifiera installationen: Kör mvn -version i ett kommandogränssnitt för att kontrollera att versionen är 3.6.3 eller senare

Installera paketet

Det här avsnittet vägleder dig genom att installera Kusto-klientbiblioteket i din miljö.

I följande tabell visas klientbiblioteken och motsvarande paketnamn.

Biblioteksnamn	Description
Kusto-databibliotek	Tillhandahåller en klient för att ansluta till kluster. Använd klientbiblioteket för att fråga efter data eller köra hanteringskommandon.
Kusto Ingest-bibliotek	Tillhandahåller en klient för att mata in data i kluster. Mer information finns i Mata in data i klustret.

Lägg till Kusto-klientbiblioteken för önskat språk i projektet eller använd den pakethanterare som är lämplig för ditt språk för att installera klientbiblioteken.

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

Maskin

npm install azure-kusto-data
npm install azure-kusto-ingest

Java

När du skapar appar använder du maven-archetype-quickstart Maven-mallen för paketet enligt följande.

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

Lägg sedan till följande beroenden i pom.xml och ersätt artefaktversionerna med den senaste tillgängliga versionen på Maven Central för kusto-data och 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>

Du måste också lägga till plugin-programmet maven-compiler-plugin och exec-maven-plugin-programmet i pom.xml. Om de inte redan finns lägger du till dem på följande sätt.

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

Kusto SDK:er innehåller exempelprogram för snabbstart. Dessa program visar hur du autentiserar, administrerar, frågar och matar in data med kusto-klientbiblioteken. Du kan använda dem som utgångspunkt för ditt eget program genom att ändra koden eller införliva specifika avsnitt i projektet.

C#

C#-snabbstartsapp

Python

Snabbstartsapp för Python

Maskin

• Node.js snabbstartsapp
• Snabbstartsapp för webbläsare

Java

Snabbstartsapp för Java

Lär dig hur du skapar appar som använder klientbibliotek

Följande artiklar beskriver hur du skapar appar som använder Kusto-klientbiblioteken.

• Skapa din första app
• Skapa en app för att köra grundläggande frågor
• Skapa en app för att köra hanteringskommandon
• Skapa en app för att hämta data med hjälp av köad inmatning

Relaterat innehåll

• Snabbreferens för KQL
• Exempelguide för appgenerator