Übersicht über die Azure Data Explorer-API

  • Artikel

Der Azure Data Explorer-Dienst unterstützt folgende Kommunikationsendpunkte:

  1. Einen REST-API-Endpunkt zum Abfragen und Verwalten der Daten in Azure Data Explorer. Dieser Endpunkt unterstützt die Kusto-Abfragesprache für Abfragen und Verwaltungsbefehle.
  2. Einen MS-TDS-Endpunkt, der einen Teil des TDS-Protokolls (Tabular Data Stream) von Microsoft implementiert, das von den Microsoft SQL Server-Produkten verwendet wird. Der Endpunkt unterstützt die TDS-Versionen 7.x und 8.0. Dieser Endpunkt ist nützlich für Tools, die mit einem SQL Server-Endpunkt für Abfragen kommunizieren können.
  3. Einen Azure Resource Manager-Endpunkt (ARM), der von Azure-Diensten standardmäßig verwendet wird. Der Endpunkt wird zum Verwalten von Ressourcen wie Azure Data Explorer-Clustern verwendet.

REST-API

Die primäre Möglichkeit der Kommunikation mit jedem Azure Data Explorer-Dienst ist die Verwendung der REST-API des Diensts. Dieser vollständig dokumentierte Endpunkt bietet Aufrufern folgende Möglichkeiten:

  • Daten abfragen
  • Abfragen und Ändern von Metadaten
  • Erfassen von Daten
  • Abfragen des Integritätsstatus des Diensts
  • Ressourcen verwalten

Die verschiedenen Azure Data Explorer-Dienste kommunizieren untereinander über die gleiche öffentlich verfügbare REST-API.

Darüber hinaus steht eine Reihe von Clientbibliotheken zur Verfügung, die die Verwendung des Diensts ermöglichen, ohne sich mit dem REST-API-Protokoll zu befassen.

MS-TDS

Azure Data Explorer unterstützt das Microsoft SQL Server Communication Protocol (MS-TDS) und bietet eine eingeschränkte Unterstützung für die Ausführung von T-SQL-Abfragen. Die unterstützten Versionen von MS-TDS umfassen 7.x und 8.0. Mit diesem Protokoll können Benutzer Abfragen in Azure Data Explorer mit einer vertrauten Abfragesyntax (T-SQL) und vertrauten Datenbankclient-Tools wie LINQPad, sqlcmd, Tableau, Excel oder Power BI ausführen.

Weitere Informationen finden Sie unter MS-TDS (T-SQL-Unterstützung).

Clientbibliotheken

Azure Data Explorer bietet eine Reihe von Clientbibliotheken, die die oben genannten Endpunkte nutzen, um den programmgesteuerten Zugriff zu vereinfachen.

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

Tipp

Sie können den Beispiel-App-Generator-Assistenten verwenden, um eine funktionierende App zu erstellen, die auf Ihren Cluster zugeschnitten ist, um Ihre Daten in Ihrer bevorzugten Programmiersprache zu erfassen und abzufragen. Der generierte Code kann als Baseline verwendet werden, um eigene Apps zu schreiben, den Code zu ändern oder Codeabschnitte in Ihre eigenen Apps zu kopieren. Weitere Informationen finden Sie unter Beispiel-App-Generator-Assistent.

.NET Framework-Bibliotheken

.NET Framework Bibliotheken sind die empfohlene Möglichkeit, programmgesteuert mit Ihrem Cluster zu interagieren. Es stehen verschiedene Bibliotheken zur Verfügung:

Die oben genannten Bibliotheken verwenden Azure-APIs, z. B. die Azure Storage-API und Microsoft Entra-API.

Python-Bibliotheken

Die Python-Clientbibliothek ermöglicht Aufrufern das Senden von Datenabfragen und Verwaltungsbefehlen. Weitere Informationen finden Sie unter Kusto Python SDK.

R-Bibliothek

Mit der R-Clientbibliothek können Aufrufer Datenabfragen und Verwaltungsbefehle senden. Weitere Informationen finden Sie unter Kusto R SDK.

Java-SDK

Die Java-Clientbibliothek bietet die Möglichkeit, Cluster mithilfe von Java abzufragen. Weitere Informationen finden Sie unter Kusto Java SDK.

Node SDK

Das Node SDK ist mit Node LTS (derzeit v6.14) kompatibel und mit ES6 erstellt. Weitere Informationen finden Sie unter Kusto Node SDK.

Go SDK

Die Go Client-Bibliothek bietet die Möglichkeit zum Abfragen, Steuern und Erfassen in Ihrem Cluster mithilfe von Go. Weitere Informationen finden Sie unter Kusto Golang SDK.

PowerShell

Die .NET Framework Bibliotheken können von PowerShell-Skripts verwendet werden. Weitere Informationen finden Sie unter Verwenden von Kusto .NET-Clientbibliotheken aus PowerShell.

Monaco-IDE-Integration

Das Paket monaco-kusto unterstützt die Integration mit dem Monaco-Webeditor. Der von Microsoft entwickelte Monaco-Editor bildet die Grundlage für Visual Studio Code. Weitere Informationen finden Sie unter Monaco-kusto.