Adatok lekérdezése az Azure Data Explorer Python-kódtárral
Ebben a cikkben az Azure Data Explorer használatával kérdezhet le adatokat. Az Azure Adatkezelő egy gyors és hatékonyan skálázható adatáttekintési szolgáltatás napló- és telemetriaadatokhoz.
Az Azure Data Explorer adatügyfélkódtárat biztosít a Pythonhoz. Ez a kódtár lehetővé teszi adatok lekérdezését a kódból. Csatlakozzon egy táblához a súgófürtön , amelyet úgy állítottunk be, hogy segítse a tanulást. Lekérdezhet egy táblát a fürtön, és visszaadhatja az eredményeket.
Előfeltételek
- Python 3.7 vagy újabb
- Microsoft-fiók vagy Microsoft Entra felhasználói identitás a súgófürt eléréséhez
Az adatkódtár telepítése
Telepítse az azure-kusto-data tárat.
pip install azure-kusto-data
Importálási utasítások és állandók hozzáadása
Importáljon osztályokat a kódtárból, valamint a pandas adatelemzési kódtárból.
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
Egy alkalmazás hitelesítéséhez az Azure Data Explorer a Microsoft Entra bérlőazonosítóját használja. A bérlőazonosító megkereséséhez használja a következő URL-címet úgy, hogy a YourDomain kifejezés helyére a saját tartományát írja be.
https://login.microsoftonline.com/<YourDomain>/.well-known/openid-configuration/
Ha például a tartomány a contoso.com, az URL-cím a következő: https://login.microsoftonline.com/contoso.com/.well-known/openid-configuration/. Kattintson erre az URL-címre az eredmények megtekintéséhez; az első sor a következő.
"authorization_endpoint":"https://login.microsoftonline.com/6babcaad-604b-40ac-a9d7-9fd97c0b779f/oauth2/authorize"
A bérlőazonosító ebben az esetben a következő: 6babcaad-604b-40ac-a9d7-9fd97c0b779f. A kód futtatása előtt állítsa be az AAD_TENANT_ID értékét.
AAD_TENANT_ID = "<TenantId>"
KUSTO_CLUSTER = "https://help.kusto.windows.net/"
KUSTO_DATABASE = "Samples"
Most hozza létre a kapcsolati sztringet. Ez a példa eszközhitelesítést használ a fürt eléréséhez. Használhat Microsoft Entra alkalmazástanúsítványt, Microsoft Entra alkalmazáskulcsot, valamint Microsoft Entra felhasználót és jelszót.
KCSB = KustoConnectionStringBuilder.with_aad_device_authentication(
KUSTO_CLUSTER)
KCSB.authority_id = AAD_TENANT_ID
Csatlakozás az Azure Data Explorerhez és lekérdezés végrehajtása
Hajtson végre egy lekérdezést a fürtön, és tárolja a kimenetet egy adatkeretben. Amikor ez a kód fut, a következőhöz hasonló üzenetet ad vissza: A bejelentkezéshez webböngészőben nyissa meg a https://microsoft.com/devicelogin oldalt, és írja be az F3W4VWZDM kódot a hitelesítéshez. Kövesse a bejelentkezési lépéseket, majd térjen vissza a következő kódblokk futtatásához.
KUSTO_CLIENT = KustoClient(KCSB)
KUSTO_QUERY = "StormEvents | sort by StartTime desc | take 10"
RESPONSE = KUSTO_CLIENT.execute(KUSTO_DATABASE, KUSTO_QUERY)
Adatok feltárása adatkeretben
A bejelentkezési adatok beírása után a lekérdezés eredményeket ad vissza, amelyek egy adatkeretben lesznek tárolva. Az eredményeket ugyanúgy használhatja, mint más adatkereteket.
df = dataframe_from_result_table(RESPONSE.primary_results[0])
df
Meg kell jelennie a StormEvents táblában szereplő első tíz eredménynek.