Compartilhar via

Visão geral da API do Azure Data Explorer

  • Artigo

O serviço do Azure Data Explorer é compatível com os seguintes pontos de extremidade de comunicação:

  1. Um ponto de extremidade da API REST, por meio do qual é possível consultar e gerenciar os dados no Azure Data Explorer. Esse ponto de extremidade dá suporte à Linguagem de Consulta Kusto para consultas e comandos de gerenciamento.
  2. Um ponto de extremidade do MS-TDS que implementa um subconjunto do protocolo TDS da Microsoft, usado pelos produtos Microsoft SQL Server. O ponto de extremidade dá suporte às versões 7.x e 8.0 do TDS. Esse ponto de extremidade é útil para ferramentas que sabem como se comunicar com um ponto de extremidade do SQL Server para consultas.
  3. Um ponto de extremidade do ARM (Azure Resource Manager) que é o meio padrão para os serviços do Azure. O ponto de extremidade é usado para gerenciar recursos, como os clusters do Azure Data Explorer.

API REST

O principal meio de comunicação com qualquer serviço de Data Explorer do Azure é usando a API REST do serviço. Com esse ponto de extremidade totalmente documentado, os chamadores poderão:

  • Consultar dados
  • Consultar e modificar metadados
  • Ingestão de dados
  • Consultar o status de integridade do serviço
  • Gerenciar recursos

Os diferentes serviços do Azure Data Explorer se comunicam entre si por meio da mesma API REST disponível publicamente.

Também há várias bibliotecas de cliente disponíveis para usar o serviço sem lidar com o protocolo da API REST.

MS-TDS

O Azure Data Explorer dá suporte ao protocolo de comunicação do Microsoft SQL Server (MS-TDS) e inclui um suporte limitado para executar consultas T-SQL. As versões com suporte do MS-TDS incluem 7.x e 8.0. Esse protocolo permite que os usuários executem consultas no Azure Data Explorer usando uma sintaxe de consulta conhecida (T-SQL) e as ferramentas de cliente de banco de dados, como LINQPad, sqlcmd, Tableau, Excel e Power BI.

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

Bibliotecas de cliente

O Azure Data Explorer fornece várias bibliotecas de clientes que usam os pontos de extremidade acima para facilitar o acesso programático.

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

Dica

Você pode usar o assistente de gerador de aplicativo de exemplo para criar um aplicativo de trabalho adaptado ao cluster, para ingerir e consultar seus dados em sua linguagem de programação preferida. O código gerado pode ser usado como uma linha de base para escrever seus próprios aplicativos, alterar o código conforme o uso ou copiar seções de código em seus próprios aplicativos. Para obter mais informações, consulte Assistente de gerador de aplicativo de exemplo.

Bibliotecas do .NET Framework

.NET Framework Bibliotecas são a maneira recomendada de interagir com o cluster programaticamente. Várias bibliotecas diferentes estão disponíveis.

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

Bibliotecas de Python

A biblioteca de clientes do Python permite que os chamadores enviem consultas de dados e comandos de gerenciamento. Para obter mais informações, consulte SDK do Python do Kusto.

Biblioteca do R

A biblioteca de clientes do R permite que os chamadores enviem consultas de dados e comandos de gerenciamento. Para obter mais informações, consulte SDK do Kusto R.

Java SDK

A biblioteca de clientes Java fornece a capacidade de consultar clusters usando Java. Para obter mais informações, consulte SDK do Java do Kusto.

SDK do Node

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

SDK do Go

A biblioteca cliente Go fornece a capacidade de consultar, controlar e ingerir em seu cluster usando o Go. Para obter mais informações, consulte SDK do Kusto Golang.

PowerShell

As bibliotecas de .NET Framework podem ser usadas por scripts do PowerShell. Para obter mais informações, consulte Usar bibliotecas de clientes kusto .NET do PowerShell.

Integração de IDE do Monaco

O pacote de monaco-kusto dá suporte à integração com o editor da Web Monaco. O Editor Monaco, desenvolvido pela Microsoft, é a base para o Visual Studio Code. Para obter mais informações, confira o pacote monaco-kusto.