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 e consulte a tabela e retorne 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

Importar classes da azure.kusto biblioteca e pandasuma 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/. Navegue até essa URL e localize authentication_endpoint nos resultados.

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

A ID do locatário neste caso é aaaabbbb-0000-cccc-1111-dddd2222eeee. 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ágina https://microsoft.com/devicelogin e insira 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 de inserir uma entrada, a consulta retorna os 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 10 principais resultados da tabela StormEvents.

Próxima etapa