Panoramica dell'API di Esplora dati di Azure

  • Articolo

Il servizio Esplora dati di Azure supporta gli endpoint di comunicazione seguenti:

  1. Un endpoint dell'API REST, tramite il quale è possibile eseguire query e gestire i dati in Esplora dati di Azure. Questo endpoint supporta la Linguaggio di query Kusto per le query e i comandi di gestione.
  2. Un endpoint MS-TDS, che implementa un sottoinsieme del protocollo Microsoft TDS (Tabular Data Stream), usato dai prodotti Microsoft SQL Server. L'endpoint supporta TDS versioni 7.x e 8.0. Questo endpoint è utile per gli strumenti che possono comunicare con un endpoint SQL Server per le query.
  3. Un endpoint Azure Resource Manager che rappresenta lo strumento standard per i servizi di Azure. L'endpoint viene usato per gestire le risorse, ad esempio i cluster di Esplora dati di Azure.

API REST

Il mezzo principale per comunicare con qualsiasi servizio di Esplora dati di Azure consiste nell'usare l'API REST del servizio. Con questo endpoint completamente documentato i chiamanti possono:

  • Eseguire query sui dati
  • Eseguire query sui metadati e modificarli
  • Inserire dati
  • Eseguire query sullo stato di integrità del servizio
  • Gestione di risorse

I diversi servizi Esplora dati di Azure comunicano tra loro, tramite la stessa API REST disponibile pubblicamente.

Sono anche disponibili diverse librerie client per l'uso del servizio, senza la necessità di gestire il protocollo API REST.

MS-TDS

Azure Esplora dati supporta il protocollo di comunicazione microsoft SQL Server (MS-TDS) e include un supporto limitato per l'esecuzione di query T-SQL. Le versioni supportate di MS-TDS includono 7.x e 8.0. Questo protocollo consente agli utenti di eseguire query su Esplora dati di Azure usando una sintassi di query nota (T-SQL) e strumenti client di database come LINQPad, sqlcmd, Tableau, Excel e Power BI.

Per altre informazioni, vedere MS-TDS.

Librerie client

Azure Esplora dati offre una serie di librerie client che usano gli endpoint precedenti per semplificare l'accesso a livello di codice.

  • .NET SDK
  • Python SDK
  • R
  • SDK per Java
  • Node SDK
  • Go SDK
  • PowerShell

Suggerimento

È possibile usare la creazione guidata del generatore di app di esempio per creare un'app funzionante personalizzata per il cluster, per inserire ed eseguire query sui dati nel linguaggio di programmazione preferito. Il codice generato può essere usato come linea di base per scrivere app personalizzate, modificare il codice man mano che si procede oppure copiare sezioni di codice nelle proprie app. Per altre informazioni, vedere Creazione guidata generatore di app di esempio.

Librerie di .NET Framework

Le librerie .NET Framework sono il modo consigliato per interagire con il cluster a livello di codice. Sono disponibili varie librerie diverse.

Le librerie precedenti usano le API di Azure, ad esempio l'API di archiviazione di Azure e Microsoft Entra API.

Librerie Python

La libreria client Python consente ai chiamanti di inviare query sui dati e comandi di gestione. Per altre informazioni, vedere Kusto Python SDK.

Libreria R

La libreria client R consente ai chiamanti di inviare query sui dati e comandi di gestione. Per altre informazioni, vedere Kusto R SDK.

SDK per Java

La libreria client Java offre la possibilità di eseguire query sui cluster usando Java. Per altre informazioni, vedere Kusto Java SDK.

Node SDK

Node SDK è compatibile con Node LTS (attualmente v6.14) e compilato con ES6. Per altre informazioni, vedere Kusto Node SDK.

Go SDK

La libreria Go Client offre la possibilità di eseguire query, controllare e inserire nel cluster tramite Go. Per altre informazioni, vedere Kusto Golang SDK.

PowerShell

Le librerie .NET Framework possono essere usate dagli script di PowerShell. Per altre informazioni, vedere Usare librerie client Kusto .NET da PowerShell.

Integrazione dell'IDE Monaco

Il pacchetto monaco-kusto supporta l'integrazione con l'editor Web Monaco. L'editor Monaco, sviluppato da Microsoft, costituisce la base per Visual Studio Code. Per altre informazioni, vedere Pacchetto monaco-kusto.