Consultar dados usando a biblioteca Python do Azure Data Explorer

Neste artigo, você consulta dados usando o Azure Data Explorer. O Azure Data Explorer é um serviço de exploração de dados rápido e altamente escalável para dados de log e telemetria.

O Azure Data Explorer fornece uma biblioteca de cliente de dados para Python. Essa biblioteca permite que você consulte dados do seu código. Conecte-se a uma tabela no cluster de ajuda, 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

Importe classes da azure.kusto biblioteca e 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 o seu ID de inquilino, utilize o seguinte URL, substituindo o seu domínio por YourDomain.

https://login.microsoftonline.com/<YourDomain>/.well-known/openid-configuration/

Por exemplo, se o seu domínio for contoso.com, o URL é: https://login.microsoftonline.com/contoso.com/.well-known/openid-configuration/. Navegue até este URL e encontre authentication_endpoint nos resultados.

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

O ID do inquilino, 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 conexão. Este exemplo usa a autenticação de dispositivo para acessar o cluster. Você também pode usar o certificado do aplicativo Microsoft Entra, a chave do aplicativo 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

Conectar-se ao Azure Data Explorer e executar 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 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 um login, a consulta retorna os resultados e eles são armazenados em um quadro de dados. Você pode trabalhar com os resultados como faz com qualquer outro quadro de dados.

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

Você deve ver os 10 melhores resultados da tabela StormEvents.

Próximo passo