Overzicht van de API voor Azure Data Explorer

  • Artikel

De Azure Data Explorer-service ondersteunt de volgende communicatie eindpunten:

  1. Een REST API-eindpunt, waarmee u de gegevens in Azure Data Explorer kunt opvragen en beheren. Dit eindpunt ondersteunt de Kusto-querytaal voor query's en beheeropdrachten.
  2. Een MS-TDS-eindpunt waarmee een subset van het TDS-protocol (Tabular Data Stream, tabellaire gegevensstroom) van Microsoft wordt geïmplementeerd. Die wordt gebruikt door de Microsoft SQL Server-producten. Het eindpunt ondersteunt TDS-versies 7.x en 8.0. Dit eindpunt is nuttig voor hulpprogramma's die weten hoe ze met een SQL Server-eindpunt kunnen communiceren voor query's.
  3. Een Azure Resource Manager-eindpunt (ARM), de standaard voor Azure-services. Het eindpunt wordt gebruikt om resources te beheren, zoals Azure Data Explorer-clusters.

REST-API

De primaire manier om te communiceren met een Azure Data Explorer-service is met behulp van de REST API van de service. Met dit volledig gedocumenteerde eindpunt kunt u het volgende opvragen en/of doen:

  • Querygegevens
  • Metagegevens opvragen en wijzigen
  • Gegevens opnemen
  • De status van de status opvragen
  • Resources beheren

De verschillende Azure Data Explorer-services communiceren onderling via dezelfde openbaar beschikbare REST API.

Er zijn ook een aantal clientbibliotheken beschikbaar om de service te gebruiken zonder het REST API-protocol te gebruiken.

MS-TDS

Azure Data Explorer ondersteunt het Microsoft SQL Server Communication Protocol (MS-TDS) en biedt beperkte ondersteuning voor het uitvoeren van T-SQL-query's. De ondersteunde versies van MS-TDS zijn 7.x en 8.0. Met dit protocol kunnen gebruikers query's op Azure Data Explorer uitvoeren met behulp van een querysyntaxis (T-SQL) en bekende databaseclient-hulpprogramma's zoals LINQPad, sqlcmd, Tableau, Excel en Power BI.

Raadpleeg MS-TDS voor meer informatie.

Clientbibliotheken

Azure Data Explorer biedt een aantal clientbibliotheken die gebruikmaken van de bovenstaande eindpunten, om programmatische toegang eenvoudig te maken.

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

Tip

U kunt de voorbeeldwizard voor het genereren van apps gebruiken om een werkende app te maken die is afgestemd op uw cluster, om uw gegevens op te nemen en er query's op uit te voeren in de programmeertaal van uw voorkeur. De gegenereerde code kan worden gebruikt als basislijn om uw eigen apps te schrijven, de code onderweg te wijzigen of u kunt secties met code kopiëren naar uw eigen apps. Zie de voorbeeldwizard voor app-generator voor meer informatie.

.NET Framework-bibliotheken

.NET Framework-bibliotheken zijn de aanbevolen manier om programmatisch met uw cluster te communiceren. Er zijn verschillende kant-en-klare bibliotheken beschikbaar.

De bovenstaande bibliotheken maken gebruik van Azure-API's, zoals Azure Storage-API en Microsoft Entra-API.

Python-bibliotheken

Met de Python-clientbibliotheek kunnen aanroepers gegevensquery's en beheeropdrachten verzenden. Zie Kusto Python SDK voor meer informatie.

R-bibliotheek

Met de R-clientbibliotheek kunnen aanroepers gegevensquery's en beheeropdrachten verzenden. Zie Kusto R SDK voor meer informatie.

Java-SDK

De Java-clientbibliotheek biedt de mogelijkheid om query's uit te voeren op clusters met behulp van Java. Zie Kusto Java SDK voor meer informatie.

Node SDK

De Node SDK is compatibel met Node LTS (momenteel v6.14) en is gebouwd met ES6. Zie Kusto Node SDK voor meer informatie.

Go-SDK

De Go-clientbibliotheek biedt de mogelijkheid om query's uit te voeren, te beheren en op te nemen in uw cluster met behulp van Go. Zie Kusto Golang SDK voor meer informatie.

PowerShell

De .NET Framework-bibliotheken kunnen worden gebruikt door PowerShell-scripts. Zie Kusto .NET-clientbibliotheken gebruiken vanuit PowerShell voor meer informatie.

IDE-integratie voor Monaco

Het monaco-kusto-pakket ondersteunt integratie met de Monaco-webeditor. De Monaco Editor is ontwikkeld door Microsoft en de basis voor Visual Studio Code. Raadpleeg monaco-kusto-pakket voor meer informatie.