Описание API Azure Data Explorer

  • Статья

Служба Azure Data Explorer поддерживает следующие конечные точки для взаимодействия:

  1. Конечная точка REST API, с помощью которой можно запрашивать данные и управлять ими в Azure Data Explorer. Эта конечная точка поддерживает язык запросов Kusto для запросов и команд управления.
  2. Конечная точка MS-TDS, которая реализует ряд возможностей протокола Microsoft TDS (поток табличных данных), используемых в продуктах Microsoft SQL Server. Конечная точка поддерживает TDS версий 7.x и 8.0. Эта конечная точка применяется для средств, которые могут взаимодействовать с конечной точкой SQL Server для отправки запросов.
  3. Конечная точка Azure Resource Manager (ARM), которая является стандартным решением для служб Azure. Она используется для управления ресурсами, такими как кластеры Azure Data Explorer.

REST API

Основным средством взаимодействия с любой службой azure Data Explorer является использование REST API службы. Благодаря этой полностью документированной конечной точке вызывающие объекты могут выполнять следующее:

  • запрашивать данные;
  • запросы к метаданным и их изменение;
  • Прием данных
  • запрос состояния работоспособности службы;
  • Управление ресурсами

Разные службы Azure Data Explorer взаимодействуют между собой через один и тот же общедоступный интерфейс REST API.

Можно также использовать различные клиентские библиотеки, которые позволяют работать со службой без применения протокола REST API.

MS-TDS

Azure Data Explorer поддерживает протокол связи Microsoft SQL Server (MS-TDS) и ограниченную поддержку выполнения запросов T-SQL. Поддерживаемые версии MS-TDS включают версии 7.x и 8.0. Этот протокол позволяет выполнять запросы к Azure Data Explorer с помощью знакомого синтаксиса запросов (T-SQL) и клиентских средств для работы с базами данных (например, LINQPad, sqlcmd, Tableau, Excel и Power BI).

Дополнительные сведения см. в статье Поддержка MS-TDS T-SQL.

Клиентские библиотеки

Azure Data Explorer предоставляет ряд клиентских библиотек, которые используют указанные выше конечные точки, чтобы упростить программный доступ.

  • Пакет SDK для .NET
  • Пакет SDK для Python
  • R
  • Пакет SDK для Java
  • Пакет SDK для Node
  • Пакет SDK для GO
  • PowerShell

Совет

Мастер генератора примеров приложений можно использовать для создания рабочего приложения, адаптированного к кластеру, для приема и запроса данных на предпочитаемом языке программирования. Созданный код можно использовать в качестве базового плана для написания собственных приложений, изменения кода по мере использования или копирования разделов кода в собственные приложения. Дополнительные сведения см. в разделе Пример мастера генератора приложений.

Библиотеки платформы .NET

библиотеки платформа .NET Framework — это рекомендуемый способ программного взаимодействия с кластером. Предоставляется несколько библиотек:

Приведенные выше библиотеки используют API Azure, такие как API службы хранилища Azure и API Microsoft Entra.

Библиотеки Python

Клиентская библиотека Python позволяет вызывающим абонентам отправлять запросы данных и команды управления. Дополнительные сведения см. в статье Пакет SDK для Python для Kusto.

Библиотека R

Клиентская библиотека R позволяет вызывающим абонентам отправлять запросы данных и команды управления. Дополнительные сведения см. в статье Kusto R SDK.

Пакет SDK для Java

Клиентская библиотека Java предоставляет возможность запрашивать кластеры с помощью Java. Дополнительные сведения см. в разделе Пакет SDK для Java для Kusto.

Пакет SDK для Node

Пакет SDK для Node совместим с Node LTS (в настоящее время версия 6.14) и создан с помощью ES6. Дополнительные сведения см. в разделе Пакет SDK для Kusto Node.

Пакет SDK для GO

Клиентская библиотека Go предоставляет возможность запрашивать, контролировать и принимать в кластере с помощью Go. Дополнительные сведения см. в разделе Пакет SDK для Kusto Golang.

PowerShell

Библиотеки платформа .NET Framework могут использоваться скриптами PowerShell. Дополнительные сведения см. в статье Использование клиентских библиотек Kusto .NET из PowerShell.

Интеграция Monaco с IDE

Пакет monaco-kusto поддерживает интеграцию с веб-редактором Monaco. Редактор Monaco, разработанный корпорацией Майкрософт, служит основой для Visual Studio Code. Дополнительные сведения см. в статье о пакете monaco-kusto.