Introducción a Azure Data Explorer API

  • Artículo

El servicio Azure Data Explorer admite los siguientes puntos de conexión de comunicación:

  1. Un punto de conexión de API REST, a través del que es posible consultar y administrar los datos en Azure Data Explorer. Este punto de conexión admite el Lenguaje de consulta Kusto para consultas y comandos de administración.
  2. Un punto de conexión de MS-TDS que implementa un subconjunto del protocolo Microsoft Tabular Data Stream (TDS), que utilizan los productos de Microsoft SQL Server. El punto de conexión admite las versiones 7.x y 8.0 de TDS. Este punto de conexión es útil para aquellas herramientas que saben cómo comunicarse con un punto de conexión de SQL Server para las consultas.
  3. Un punto de conexión de Azure Resource Manager que es el medio estándar para los servicios de Azure. El punto de conexión se usa para administrar recursos, como los clústeres de Azure Data Explorer.

API REST

El medio principal para comunicarse con cualquier servicio de Azure Data Explorer es mediante la API REST del servicio. Con este punto de conexión completamente documentado, los autores de las llamadas pueden:

  • Consultar datos
  • Consultar y modificar metadatos
  • Ingerir datos
  • Consultar el estado del mantenimiento del servicio
  • Administrar recursos

Los diferentes servicios de Azure Data Explorer se comunican entre ellos mediante la misma API REST disponible públicamente.

Hay varias bibliotecas cliente disponibles para usar el servicio sin tener que utilizar el protocolo de la API REST.

MS-TDS

Azure Data Explorer admite el protocolo de comunicación de Microsoft SQL Server (MS-TDS) e incluye una compatibilidad limitada para ejecutar consultas T-SQL. Las versiones compatibles de MS-TDS incluyen 7.x y 8.0. Este protocolo permite a los usuarios ejecutar consultas en Azure Data Explorer mediante una sintaxis de consulta conocida (T-SQL) y las herramientas de cliente de base de datos, como LINQPad, sqlcmd, Tableau, Excel y Power BI.

Para más información, consulte MS-TDS.

Bibliotecas de clientes

Azure Data Explorer proporciona una serie de bibliotecas cliente que usan los puntos de conexión anteriores para facilitar el acceso mediante programación.

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

Sugerencia

Puede usar el Asistente para generador de aplicaciones de ejemplo para crear una aplicación de trabajo adaptada al clúster, para ingerir y consultar los datos en el lenguaje de programación que prefiera. El código generado se puede usar como línea base para escribir sus propias aplicaciones, modificar el código a medida que vaya, o bien puede copiar secciones de código en sus propias aplicaciones. Para obtener más información, consulte el Asistente para generadores de aplicaciones de ejemplo.

Bibliotecas de .NET Framework

Las bibliotecas de .NET Framework son la manera recomendada de interactuar con el clúster mediante programación. Hay varias bibliotecas diferentes disponibles.

Las bibliotecas anteriores usan las API de Azure, como la API de Azure Storage y la API de Microsoft Entra.

Bibliotecas de Python

La biblioteca cliente de Python permite a los autores de llamadas enviar consultas de datos y comandos de administración. Para más información, consulte SDK de Python de Kusto.

Biblioteca de R

La biblioteca cliente de R permite a los autores de llamadas enviar consultas de datos y comandos de administración. Para más información, consulte SDK de Kusto R.

SDK de Java

La biblioteca cliente de Java proporciona la capacidad de consultar clústeres mediante Java. Para obtener más información, consulte SDK de Java de Kusto.

SDK de Node

El SDK de Node es compatible con Node LTS (actualmente v6.14) y compilado con ES6. Para obtener más información, consulte SDK de Kusto Node.

Go SDK

La biblioteca cliente de Go proporciona la capacidad de consultar, controlar e ingerir en el clúster mediante Go. Para obtener más información, consulte SDK de Kusto Golang.

PowerShell

Los scripts de PowerShell pueden usar las bibliotecas de .NET Framework. Para más información, consulte Uso de bibliotecas de cliente de .NET de Kusto desde PowerShell.

Integración del IDE Mónaco

El paquete monaco-kusto admite la integración con el editor web Mónaco. El editor Mónaco, desarrollado por Microsoft, es la base de Visual Studio Code. Para más información, consulte Paquete monaco-kusto.