Översikt av Azure Data Explorer API

  • Artikel

Tjänsten Azure Data Explorer stöder följande kommunikationsslutpunkter:

  1. En REST API-slutpunkt genom vilken du kan köra frågor mot och hantera data i Azure Data Explorer. Den här slutpunkten stöder Kusto-frågespråk för frågor och hanteringskommandon.
  2. En MS-TDS-slutpunkt som implementerar en delmängd av protokollet Microsoft Tabular Data Stream (TDS), som används av Microsoft SQL Server-produkterna. Slutpunkten stöder TDS-versionerna 7.x och 8.0. Den här slutpunkten är användbar för verktyg som kan kommunicera med en SQL Server-slutpunkt för frågor.
  3. En Azure Resource Manager-slutpunkt (ARM), som är standardmetoden för Azure-tjänster. Slutpunkten används för att hantera resurser såsom Azure Data Explorer-kluster.

REST-API

Det främsta sättet att kommunicera med azure Data Explorer-tjänsten är att använda tjänstens REST-API. Med den här fullständigt dokumenterade slutpunkten kan anropare:

  • Söka i data
  • Köra frågor mot och ändra metadata
  • Mata in data
  • Köra frågor mot tjänstens hälsostatus
  • Hantera resurser

De olika Azure Data Explorer-tjänsterna kommunicerar sinsemellan via samma offentligt tillgängliga REST-API.

Ett antal klientbibliotek finns också tillgängliga för att använda tjänsten utan att behöva REST API-protokollet.

MS-TDS

Azure Data Explorer stöder Ms-TDS (Microsoft SQL Server Communication Protocol) och har ett begränsat stöd för att köra T-SQL-frågor. De versioner av MS-TDS som stöds är 7.x och 8.0. Det här protokollet gör att användarna kan köra frågor på Azure Data Explorer med hjälp av en välkänd frågesyntax (T-SQL) och databasklientverktyg (till exempel LINQPad, sqlcmd, Tableau, Excel och Power BI).

Mer information finns i artikeln MS-TDS.

Klientbibliotek

Azure Data Explorer tillhandahåller ett antal klientbibliotek som använder ovanstående slutpunkter för att göra programmatisk åtkomst enkel.

  • .NET SDK
  • Python SDK
  • R
  • Java SDK
  • SDK för Node
  • Go SDK
  • PowerShell

Tips

Du kan använda exempelguiden för appgeneratorn för att skapa en fungerande app som är skräddarsydd för klustret för att mata in och fråga efter dina data på önskat programmeringsspråk. Den genererade koden kan användas som baslinje för att skriva egna appar, ändra koden per användning eller kopiera kodavsnitt till dina egna appar. Mer information finns i exempelguiden för appgenerator.

.NET Framework-bibliotek

.NET Framework bibliotek är det rekommenderade sättet att interagera med klustret programmatiskt. Det finns ett antal olika tillgängliga bibliotek.

Ovanstående bibliotek använder Azure-API:er, till exempel Azure Storage API och Microsoft Entra API.

Python-bibliotek

Python-klientbiblioteket tillåter anropare att skicka datafrågor och hanteringskommandon. Mer information finns i Kusto Python SDK.

R-bibliotek

R-klientbiblioteket tillåter anropare att skicka datafrågor och hanteringskommandon. Mer information finns i Kusto R SDK.

Java SDK

Java-klientbiblioteket ger möjlighet att köra frågor mot kluster med hjälp av Java. Mer information finns i Kusto Java SDK.

SDK för Node

Node SDK är kompatibelt med Node LTS (för närvarande v6.14) och har skapats med ES6. Mer information finns i Kusto Node SDK.

Go SDK

Go-klientbiblioteket ger möjlighet att fråga, styra och mata in i klustret med hjälp av Go. Mer information finns i Kusto Golang SDK.

PowerShell

De .NET Framework biblioteken kan användas av PowerShell-skript. Mer information finns i Använda Kusto .NET-klientbibliotek från PowerShell.

Monaco IDE-integrering

Paketet monaco-kusto stöder integrering med webbredigeringsprogrammet Monaco. Monaco har utvecklats av Microsoft och utgör grunden för Visual Studio Code. Mer information finns i monaco-kusto-paketet.