Si applica a: ✅Microsoft Fabric✅Esplora dati di Azure
Configurare l'ambiente per l'uso delle librerie client Kusto. Queste librerie consentono di creare app che si connettono a un cluster, eseguono query o inseriscono dati.
Questo articolo illustra come installare i pacchetti della libreria client per la lingua preferita.
Prerequisiti
Scegliere i prerequisiti per il linguaggio di programmazione usato per creare l'app.
Annotazioni
Le librerie client Kusto sono compatibili con JavaScript e TypeScript. Per convertire esempi TypeScript in JavaScript, rimuovere le annotazioni di tipo usate per variabili, parametri e valori restituiti.
Uno o più 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 successiva
Verificare l'installazione: in una shell dei comandi eseguire dotnet sdk check per verificare che le versioni installate soddisfino i requisiti minimi.
-
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.
Nodo 16 o versione successiva compilata con ES6
- Verificare che il
node file eseguibile si trova nel PATH
- 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 login, usa la libreria @auzre/identità per rilasciare un token di autorizzazione e usa withTokenProvider per fornire questo token al Kusto client:
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:
-
Creare una registrazione dell'applicazione Microsoft Entra
- Nella scheda Autenticazione selezionare + Aggiungi una piattaforma. Selezionare quindi applicazione a pagina singola.
- Immettere gli URI di reindirizzamento desiderati, selezionare le caselle token di accesso e token ID e selezionare Configura. Altre informazioni sugli URI di reindirizzamento nell'app desktop che chiama le API web.
-
Configurare le autorizzazioni delegate per l'applicazione.
-
Concedere all'applicazione l'accesso al database.
- Nella scheda Panoramica copiare l'ID applicazione (client).
Gli esempi in tutte le esercitazioni seguenti usano la libreria client Kusto per attivare l'autenticazione.
Annotazioni
Se si appartiene a un'organizzazione, le restrizioni basate sulle configurazioni dell'organizzazione potrebbero impedire l'autenticazione. Richiedere l'accesso da un amministratore dell'organizzazione o riprovare in un account personale.
- 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
- Verificare che il
mvn file eseguibile si trova nel PATH
- 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 in uso.
Nella tabella seguente sono elencate le librerie client e i nomi dei pacchetti corrispondenti.
Aggiungi le librerie client Kusto per la lingua preferita al progetto. Usare la gestione pacchetti appropriata per la lingua per installare le librerie client.
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
Usare il modello Maven-archetype-quickstart Maven per creare app, come indicato di seguito.
mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId==my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false
Aggiungere le dipendenze seguenti al pom.xml. Sostituire le versioni degli artefatti 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>
Aggiungere i plugin maven-compiler-plugin e exec-maven-plugin al pom.xml. Se non esistono, aggiungerli come indicato di seguito.
<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 includono applicazioni di esempio di avvio rapido che illustrano come autenticare, amministrare, eseguire query e inserire dati usando le librerie client Kusto. Usarli come punto di partenza per l'applicazione modificando il codice o incorporando sezioni specifiche nel progetto.
Informazioni su come creare app che usano librerie client
Gli articoli seguenti illustrano la creazione di app che usano le librerie client Kusto.
Contenuti correlati