Inicio rápido: Consulta de datos mediante la biblioteca de Python de Azure Data ExplorerQuickstart: Query data using the Azure Data Explorer Python library

El Explorador de datos de Azure es un servicio de exploración de datos altamente escalable y rápido para datos de telemetría y registro.Azure Data Explorer is a fast and highly scalable data exploration service for log and telemetry data. El Explorador de datos de Azure proporciona un biblioteca de cliente de datos para Python.Azure Data Explorer provides a data client library for Python. Esta biblioteca permite consultar los datos desde el código.This library enables you to query data from your code. En esta guía de inicio rápido, se conecta a una tabla en el clúster de ayuda que hemos configurado para facilitar el aprendizaje.In this quickstart, you connect to a table on the help cluster that we have set up to aid learning. A continuación, consulta una tabla en ese clúster, que devuelve los resultados.You then query a table on that cluster and return the results.

Esta guía de inicio rápido también está disponible como un Azure Notebook.This quickstart is also available as an Azure Notebook.

Requisitos previosPrerequisites

  • Una cuenta de correo electrónico organizativa que sea miembro de Azure Active Directory (AAD)An organizational email account that is a member of Azure Active Directory (AAD)

  • Python instalado en el equipo de desarrolloPython installed on your development computer

Instalar la biblioteca de datosInstall the data library

Instale azure-kusto-data.Install azure-kusto-data.

pip install azure-kusto-data

Agregar instrucciones y constantes de importaciónAdd import statements and constants

Importe clases de la biblioteca, así como Pandas, una biblioteca de análisis de datos.Import classes from the library, as well as pandas, a data analysis library.

from azure.kusto.data.request import KustoClient, KustoConnectionStringBuilder
from azure.kusto.data.exceptions import KustoServiceError
from azure.kusto.data.helpers import dataframe_from_result_table
import pandas as pd

Para autenticar una aplicación, el Explorador de datos de Azure usa el identificador del inquilino AAD.To authenticate an application, Azure Data Explorer uses your AAD tenant ID. Para buscar el identificador de inquilino, use la dirección URL siguiente, sustituyendo su dominio por SuDominio.To find your tenant ID, use the following URL, substituting your domain for YourDomain.

https://login.windows.net/<YourDomain>/.well-known/openid-configuration/

Por ejemplo, si el nombre de dominio es contoso.com, la dirección URL es: https://login.windows.net/contoso.com/.well-known/openid-configuration/.For example, if your domain is contoso.com, the URL is: https://login.windows.net/contoso.com/.well-known/openid-configuration/. Haga clic en esta dirección URL para ver los resultados. la primera línea es como sigue.Click this URL to see the results; the first line is as follows.

"authorization_endpoint":"https://login.windows.net/6babcaad-604b-40ac-a9d7-9fd97c0b779f/oauth2/authorize"

En este caso, el identificador de inquilino es 6babcaad-604b-40ac-a9d7-9fd97c0b779f.The tenant ID in this case is 6babcaad-604b-40ac-a9d7-9fd97c0b779f. Establezca el valor de AAD_TENANT_ID antes de ejecutar este código.Set the value for AAD_TENANT_ID before running this code.

AAD_TENANT_ID = "<TenantId>"
KUSTO_CLUSTER = "https://help.kusto.windows.net/"
KUSTO_DATABASE  = "Samples"

Ahora, cree la cadena de conexión.Now construct the connection string. En este ejemplo se utiliza la autenticación de dispositivos para acceder al clúster.This example uses device authentication to access the cluster. También puede usar el certificado de la aplicación de AAD, la clave de aplicación de AAD y el usuario y la contraseña de AAD.You can also use AAD application certificate, AAD application key, and AAD user and password.

KCSB = KustoConnectionStringBuilder.with_aad_device_authentication(KUSTO_CLUSTER)
KCSB.authority_id = AAD_TENANT_ID

Conectarse al Explorador de datos de Azure y ejecutar una consultaConnect to Azure Data Explorer and execute a query

Ejecute una consulta en el clúster y almacene el resultado en un marco de datos.Execute a query against the cluster and store the output in a data frame. Cuando se ejecuta este código, devuelve un mensaje similar al siguiente: Para iniciar sesión, use un explorador web para abrir la página https://microsoft.com/devicelogin y escriba el código F3W4VWZDM para realizar la autenticación.When this code runs, it returns a message like the following: To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code F3W4VWZDM to authenticate. Siga los pasos para iniciar sesión y después vuelva a ejecutar el siguiente bloque de código.Follow the steps to sign-in, then return to run the next code block.

KUSTO_CLIENT  = KustoClient(KCSB)
KUSTO_QUERY  = "StormEvents | sort by StartTime desc | take 10"

RESPONSE = KUSTO_CLIENT.execute(KUSTO_DATABASE, KUSTO_QUERY)

Exploración de los datos en DataFrameExplore data in DataFrame

Después de especificar un inicio de sesión, la consulta devuelve resultados, que se almacenan en un marco de datos.After you enter a sign in, the query returns results, and they are stored in a data frame. Puede trabajar con los resultados como hace con cualquier otro marco de datos.You can work with the results like you do any other data frame.

df = dataframe_from_result_table(RESPONSE.primary_results[0])
df

Debe ver los diez primeros resultados de la tabla StormEvents.You should see the top ten results from the StormEvents table.

Pasos siguientesNext steps