Configurare l'ambiente di sviluppo per usare le librerie client Kusto

Informazioni su come configurare l'ambiente per usare le librerie client Kusto. È possibile usare queste librerie per creare app che si connettono a un cluster ed eseguire query o inserire dati.

In questo articolo viene illustrato come installare i pacchetti della libreria client per la lingua preferita.

Prerequisiti

Selezionare i prerequisiti per il linguaggio di programmazione usato per creare l'app.

Nota

Le librerie client Kusto sono compatibili con JavaScript e TypeScript. Per convertire esempi TypeScript in JavaScript, rimuovere semplicemente le annotazioni di tipo usate per variabili, parametri e valori restituiti.

C#

Uno o più dei framework .NET SDK seguenti:

• .NET SDK 5.0 o versione successiva
• .NET Core 2.1 o versione successiva
• .NET Standard 2.1 o versione successiva
• .NET Framework 4.7.2 o versioni successive

Verificare l'installazione: in una shell dei comandi eseguire dotnet sdk check per verificare che le versioni installate soddisfino i requisiti minimi.

Python

• Python 3.7 o versione successiva
  • Assicurarsi che il file eseguibile si trova nell'oggetto pythonPATH
  • Verificare l'installazione: in una shell dei comandi eseguire python --version per verificare che la versione sia 3.7 o successiva

Typescript

• Nodo 16 o versione successiva compilata con ES6

  • Assicurarsi che il file eseguibile si trova nell'oggetto nodePATH
  • Verificare l'installazione: in una shell dei comandi eseguire node --version per verificare che la versione sia 3.7 o successiva

• Un'app Node.js o un'app Web basata su browser, ad esempio un'app React.

• Per le app Web basate su browser:

  • Se l'app ha un'esperienza di accesso, è possibile usare la libreria di @auzre/identità per rilasciare un token di autorizzazione e usare withTokenProvider per inviare questo token al client Kusto:

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

  • Se l'app non ha un'esperienza di accesso o si preferisce usare la libreria client Kusto per richiedere l'autenticazione, è necessario configurare una registrazione dell'applicazione con le autorizzazioni necessarie:

    1. Creare una registrazione dell'applicazione Microsoft Entra.
    2. Nella scheda Autenticazione selezionare + Aggiungi una piattaforma. Selezionare quindi applicazione a pagina singola.
    3. Immettere gli URI di reindirizzamento desiderati, selezionare le caselle per Token di accesso e token ID e selezionare Configura. Per altre informazioni sugli URI di reindirizzamento, vedere App desktop che chiama le API Web.
    4. Configurare le autorizzazioni delegate per l'applicazione.
    5. Concedere all'applicazione l'accesso al database di Esplora dati di Azure.
    6. Nella scheda Panoramica copiare l'ID applicazione (client).

    Gli esempi in tutte le esercitazioni seguenti usano la libreria client Kusto per richiedere l'autenticazione.

    Nota

    Se si appartiene a un'organizzazione, le restrizioni basate sulle configurazioni dell'organizzazione potrebbero impedire l'autenticazione. Chiedere l'accesso da un amministratore dell'organizzazione o riprovare in un account personale.

Java

• JDK 8 o versione successiva
  • Assicurarsi che il file eseguibile si trova nell'oggetto javaPATH
  • Verificare l'installazione: in una shell dei comandi eseguire java -version per verificare che la versione sia 8 o successiva
• Maven 3.6.3 o versione successiva
  • Assicurarsi che il file eseguibile si trova nell'oggetto mvnPATH
  • Verificare l'installazione: in una shell dei comandi eseguire mvn -version per verificare che la versione sia 3.6.3 o successiva

Installare il pacchetto

Questa sezione illustra come installare la libreria client Kusto nell'ambiente.

Nella tabella seguente sono elencate le librerie client e i nomi dei pacchetti corrispondenti.

Nome della libreria	Descrizione
Raccolta dati Kusto	Fornisce un client per la connessione ai cluster. Usare la libreria client per eseguire query sui dati o eseguire comandi di gestione.
Libreria Di inserimento Kusto	Fornisce un client per l'inserimento dei dati nei cluster. Per altre informazioni, vedere Inserire dati nel cluster.

Aggiungere le librerie client Kusto per la lingua preferita al progetto oppure usare la gestione pacchetti appropriata per la lingua per installare le librerie client.

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

Quando si creano app, usare il modello maven-archetype-quickstart Maven per il pacchetto, come indicato di seguito.

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

Aggiungere quindi le dipendenze seguenti al pom.xml, sostituendo le versioni dell'artefatto con la versione più recente disponibile in Maven Central per kusto-data e 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>

È anche necessario aggiungere i plug-in maven-compilatore e plug-in exec-maven-plug-in nell'pom.xml. Se non esistono già, aggiungerli come segue.

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

Gli SDK Kusto contengono applicazioni di esempio di avvio rapido. Queste applicazioni illustrano come autenticare, amministrare, eseguire query e inserire dati usando le librerie client Kusto. È possibile usarli come punto di partenza per l'applicazione modificando il codice o incorporando sezioni specifiche nel progetto.

C#

App di avvio rapido C#

Python

App di avvio rapido di Python

Typescript

• app di avvio rapidoNode.js
• App di avvio rapido del browser

Java

App di avvio rapido Java

Informazioni su come creare app che usano librerie client

Gli articoli seguenti illustrano come creare app che usano le librerie client Kusto.

• Creare la prima app
• Creare un'app per eseguire query di base
• Creare un'app per eseguire i comandi di gestione
• Creare un'app per ottenere dati usando l'inserimento in coda

Contenuti correlati

• Riferimento rapido sul linguaggio KQL
• Creazione guidata generatore di app di esempio