Descrição geral da API do Azure Data Explorer

  • Artigo

O serviço Azure Data Explorer suporta os seguintes pontos finais de comunicação:

  1. Um ponto final da API REST, através do qual pode consultar e gerir os dados no Azure Data Explorer. Este ponto final suporta a Linguagem de Pesquisa Kusto para consultas e comandos de gestão.
  2. Um ponto final do MS-TDS que implementa um subconjunto do protocolo TDS (Tabular Data Stream) da Microsoft, utilizado pelos produtos Microsoft SQL Server. O ponto final suporta as versões TDS 7.x e 8.0. Este ponto final é útil para as ferramentas que saibam comunicar com um ponto final do SQL Server para consultas.
  3. Um ponto final do Azure Resource Manager (ARM) que é o meio padrão dos serviços do Azure. O ponto final é utilizado para gerir recursos como, por exemplo, os clusters do Azure Data Explorer.

API REST

O principal meio de comunicar com qualquer serviço Data Explorer do Azure é através da API REST do serviço. Com este ponto final totalmente documentado, os chamadores podem:

  • Consultar dados
  • Consultar e modificar metadados
  • Ingerir dados
  • Consultar o estado de funcionamento do serviço
  • Gerir recursos

Os diferentes serviços do Azure Data Explorer comunicam entre si, através da mesma API REST publicamente disponível.

Também está disponível um conjunto de bibliotecas de cliente que permite utilizar o serviço e, ao mesmo tempo, evitar o protocolo da API REST.

MS-TDS

O Azure Data Explorer suporta o protocolo de comunicação microsoft SQL Server (MS-TDS) e inclui um suporte limitado para executar consultas T-SQL. As versões suportadas do MS-TDS incluem 7.x e 8.0. Este protocolo permite que os utilizadores executem consultas no Azure Data Explorer com uma sintaxe de consulta (T-SQL) conhecida e com ferramentas de cliente de base de dados, tais como LINQPad, sqlcmd, Tableau, Excel e Power BI.

Para obter mais informações, veja MS-TDS.

Bibliotecas de cliente

O Azure Data Explorer fornece várias bibliotecas de cliente que utilizam os pontos finais acima para facilitar o acesso programático.

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

Dica

Pode utilizar o assistente do gerador de aplicações de exemplo para criar uma aplicação de trabalho adaptada ao cluster, para ingerir e consultar os seus dados na sua linguagem de programação preferida. O código gerado pode ser utilizado como uma linha de base para escrever as suas próprias aplicações, alterar o código à medida que avança ou pode copiar secções de código para as suas próprias aplicações. Para obter mais informações, veja Assistente de gerador de aplicações de exemplo.

Bibliotecas .NET Framework

.NET Framework Bibliotecas são a forma recomendada de interagir com o cluster programaticamente. Estão disponíveis várias bibliotecas diferentes.

As bibliotecas acima utilizam APIs do Azure, como a API de Armazenamento do Azure e Microsoft Entra API.

Bibliotecas Python

A biblioteca de cliente Python permite que os autores de chamadas enviem consultas de dados e comandos de gestão. Para obter mais informações, veja SDK kusto Python.

Biblioteca R

A biblioteca de cliente R permite que os autores de chamadas enviem consultas de dados e comandos de gestão. Para obter mais informações, veja SDK kusto R.

SDK Java

A biblioteca de cliente Java fornece a capacidade de consultar clusters com Java. Para obter mais informações, veja SDK Java kusto.

SDK de Node

O SDK de Nó é compatível com o Node LTS (atualmente v6.14) e criado com o ES6. Para obter mais informações, veja SDK do Nó kusto.

SDK Go

A biblioteca Go Client fornece a capacidade de consultar, controlar e ingerir no cluster com o Go. Para obter mais informações, veja SDK kusto Golang.

PowerShell

As bibliotecas de .NET Framework podem ser utilizadas por scripts do PowerShell. Para obter mais informações, veja Utilizar bibliotecas de cliente .NET do Kusto a partir do PowerShell.

Integração do IDE Monaco

O pacote monaco-kusto suporta a integração no editor Web Monaco. O Monaco Editor, desenvolvido pela Microsoft, é a base do Visual Studio Code. Para obter mais informações, veja o pacote monaco-kusto.