Vue d’ensemble de l’API Azure Data Explorer

  • Article

Le service Azure Data Explorer prend en charge les points de terminaison de communication suivants :

  1. Point de terminaison d’API REST, par le biais duquel vous pouvez interroger et gérer les données dans Azure Data Explorer. Ce point de terminaison prend en charge le Langage de requête Kusto pour les requêtes et les commandes de gestion.
  2. Un point de terminaison MS-TDS, qui implémente un sous-ensemble du protocole Microsoft TDS (Tabular Data Stream), utilisé par les produits Microsoft SQL Server. Le point de terminaison prend en charge les versions TDS 7.x et 8.0. Ce point de terminaison est utile pour les outils qui savent comment communiquer avec un point de terminaison SQL Server pour les requêtes.
  3. Un point de terminaison de Azure Resource Manager (ARM) qui est le moyen standard pour les services Azure. Le point de terminaison est utilisé pour gérer les ressources, comme des clusters Azure Data Explorer.

API REST

Le principal moyen de communiquer avec n’importe quel service Azure Data Explorer consiste à utiliser l’API REST du service. Avec ce point de terminaison entièrement documenté, les appelants peuvent :

  • Interroger des données
  • Interroger et modifier les métadonnées
  • Réception de données
  • Interroger l’état d’intégrité du service
  • Gestion des ressources

Les différents services Azure Data Explorer communiquent entre eux via la même API REST disponible publiquement.

Plusieurs bibliothèques de clients sont également disponibles pour utiliser le service sans avoir à gérer le protocole de l’API REST.

MS-TDS

Azure Data Explorer prend en charge le protocole de communication Microsoft SQL Server (MS-TDS) et inclut une prise en charge limitée pour l’exécution de requêtes T-SQL. Les versions prises en charge de MS-TDS incluent 7.x et 8.0. Ce protocole permet aux utilisateurs d’exécuter des requêtes sur Azure Data Explorer avec une syntaxe de requête connue (T-SQL) et d’outils de client de base de données, comme LINQPad, sqlcmd, Tableau, Excel et Power BI.

Pour plus d’informations, consultez MS-TDS.

Bibliothèques clientes

Azure Data Explorer fournit un certain nombre de bibliothèques clientes qui utilisent les points de terminaison ci-dessus pour faciliter l’accès par programmation.

  • Kit de développement logiciel (SDK) .NET
  • Kit de développement logiciel (SDK) Python
  • R
  • Kit de développement logiciel (SDK) Java
  • SDK Node
  • Kit de développement logiciel (SDK) Go
  • PowerShell

Conseil

Vous pouvez utiliser l’Assistant Générateur d’exemples d’application pour créer une application de travail adaptée à votre cluster, afin d’ingérer et d’interroger vos données dans votre langage de programmation préféré. Le code généré peut être utilisé comme base de référence pour écrire vos propres applications, modifier le code au fur et à mesure, ou vous pouvez copier des sections de code dans vos propres applications. Pour plus d’informations, consultez Exemple d’Assistant Générateur d’application.

Bibliothèques .NET Framework

Les bibliothèques .NET Framework sont la méthode recommandée pour interagir avec votre cluster par programmation. Plusieurs bibliothèques différentes sont disponibles.

Les bibliothèques ci-dessus utilisent des API Azure, telles que l’API Stockage Azure et l’API Microsoft Entra.

Bibliothèques Python

La bibliothèque cliente Python permet aux appelants d’envoyer des requêtes de données et des commandes de gestion. Pour plus d’informations, consultez Kit de développement logiciel (SDK) Python Kusto.

Bibliothèque R

La bibliothèque cliente R permet aux appelants d’envoyer des requêtes de données et des commandes de gestion. Pour plus d’informations, consultez Kit de développement logiciel (SDK) Kusto R.

Kit de développement logiciel (SDK) Java

La bibliothèque cliente Java offre la possibilité d’interroger des clusters à l’aide de Java. Pour plus d’informations, consultez Kit de développement logiciel (SDK) Java Kusto.

SDK Node

Le Kit de développement logiciel (SDK) Node est compatible avec Node LTS (actuellement v6.14) et est généré avec ES6. Pour plus d’informations, consultez Kit de développement logiciel (SDK) Kusto Node.

Kit de développement logiciel (SDK) Go

La bibliothèque cliente Go offre la possibilité d’interroger, de contrôler et d’ingérer dans votre cluster à l’aide de Go. Pour plus d’informations, consultez Kit de développement logiciel (SDK) Kusto Golang.

PowerShell

Les bibliothèques .NET Framework peuvent être utilisées par les scripts PowerShell. Pour plus d’informations, consultez Utiliser des bibliothèques clientes Kusto .NET à partir de PowerShell.

Intégration de l’IDE Monaco

Le package monaco-kusto prend en charge l’intégration à l’éditeur web de Monaco. L’éditeur Monaco, développé par Microsoft, est la base pour Visual Studio Code. Pour plus d’informations, consultez Package monaco-kusto.