Consultar dados usando a biblioteca Python do Azure Data Explorer
Neste artigo, você consultará dados usando o Azure Data Explorer. O Azure Data Explorer é um serviço de exploração de dados rápido e altamente escalonável para dados telemétricos e de log.
O Azure Data Explorer fornece uma biblioteca cliente de dados para Python. Esta biblioteca permite consultar dados do seu código. Conecte-se a uma tabela no cluster de ajuda que configuramos para ajudar no aprendizado. Você pode consultar uma tabela nesse cluster e retornar os resultados.
Pré-requisitos
- Python 3.7 ou posterior
- Uma conta da Microsoft ou uma identidade de usuário do Microsoft Entra para acessar o cluster de ajuda
Instalar a biblioteca de dados
Instale azure-kusto-data .
pip install azure-kusto-data
Adicionar instruções de importação e constantes
Importe classes da biblioteca, bem como pandas, uma biblioteca de análise de dados.
from azure.kusto.data 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 um aplicativo, o Azure Data Explorer usa sua ID de locatário do Microsoft Entra. Para encontrar seu ID de locatário, use a seguinte URL, substituindo seu domínio por YourDomain.
https://login.microsoftonline.com/<YourDomain>/.well-known/openid-configuration/
Por exemplo, se o seu domínio for contoso.com, a URL será https://login.microsoftonline.com/contoso.com/.well-known/openid-configuration/. Clique nesta URL para ver os resultados; a primeira linha é a seguinte.
"authorization_endpoint":"https://login.microsoftonline.com/6babcaad-604b-40ac-a9d7-9fd97c0b779f/oauth2/authorize"
A ID do locatário neste caso é 6babcaad-604b-40ac-a9d7-9fd97c0b779f. Defina o valor para AAD_TENANT_ID antes de executar este código.
AAD_TENANT_ID = "<TenantId>"
KUSTO_CLUSTER = "https://help.kusto.windows.net/"
KUSTO_DATABASE = "Samples"
Agora, construa a cadeia de caracteres de conexão. Este exemplo usa a autenticação do dispositivo para acessar o cluster. Você também pode usar o certificado de aplicativo do Microsoft Entra, a chave do aplicativo do Microsoft Entra e o usuário e a senha do Microsoft Entra.
KCSB = KustoConnectionStringBuilder.with_aad_device_authentication(
KUSTO_CLUSTER)
KCSB.authority_id = AAD_TENANT_ID
Conecte-se ao Azure Data Explorer e execute uma consulta
Execute uma consulta no cluster e armazene a saída em um quadro de dados. Quando esse código é executado, ele retorna uma mensagem como a seguinte: Para entrar, use um navegador da web para abrir a páginahttps://microsoft.com/devicelogin e digite o código F3W4VWZDM para autenticar. Siga as etapas para entrar e retorne para executar o próximo bloco de código.
KUSTO_CLIENT = KustoClient(KCSB)
KUSTO_QUERY = "StormEvents | sort by StartTime desc | take 10"
RESPONSE = KUSTO_CLIENT.execute(KUSTO_DATABASE, KUSTO_QUERY)
Explorar dados no DataFrame
Depois que você insere um sinal, a consulta retorna resultados e eles são armazenados em um quadro de dados. Você pode trabalhar com os resultados como qualquer outro quadro de dados.
df = dataframe_from_result_table(RESPONSE.primary_results[0])
df
Você deve ver os dez primeiros resultados da tabela StormEvents.