Delen via


Zelfstudie: Een Fabric-notebook gebruiken met Kqlmagic om een query uit te voeren op een KQL-database

Met fabric-notebooks kunt u documenten maken en delen met live code, vergelijkingen, visualisaties en verhaaltekst. Het is handig voor een breed scala aan taken, zoals het opschonen en transformeren van gegevens, numerieke simulatie, statistische modellering, gegevensvisualisatie en machine learning.

Kqlmagic breidt de mogelijkheden van de Python-kernel in Fabric-notebooks uit, zodat u KQL-query's (Kusto Query Language) systeemeigen kunt uitvoeren vanuit notebookcellen. U kunt Python en KQL combineren om gegevens op te vragen en te visualiseren met behulp van de uitgebreide Plotly-bibliotheek die is geïntegreerd met de renderoperator .

Voor meer informatie over notitieblokken, zie Hoe u Microsoft Fabric-notebooks gebruikt.

In deze zelfstudie leert u hoe u Kqlmagic gebruikt om geavanceerde query's en visualisaties uit te voeren op basis van gegevens in een KQL-database. Er worden vooraf gemaakte datasets en notebooks gebruikt in zowel de Real-Time Intelligence- als de Data Engineering-omgeving in Microsoft Fabric.

In deze handleiding leer je hoe je:

  • Een KQL-database maken
  • Gegevens ophalen
  • Een notebook importeren met Kqlmagic
  • Het notitieblok uitvoeren

Vereiste voorwaarden

1. Een KQL-database maken

In deze stap maakt u een lege KQL-database met de naam NYCTaxiDB in uw werkruimte of in een bestaand Eventhouse.

  1. Selecteer uw werkruimte in de linkernavigatiebalk.

  2. Volg een van deze stappen om een KQL-database te maken:

    • Selecteer Nieuw item en Eventhouse. Voer in het veld Eventhouse-naamNYCTaxiDB in en selecteer Maken. Er wordt een KQL-database met dezelfde naam gegenereerd.
    • Selecteer in een bestaand eventhouse Databases. Voer onder KQL-databases in het veld +NYCTaxiDB in en selecteer Maken.
  3. Selecteer de NYCTaxiDB-database , vouw databasegegevens uit, kopieer de query-URI en plak deze ergens, zoals een kladblok, om in een latere stap te gebruiken.

     Schermopname van de kaart met databasegegevens waarin de databasegegevens worden weergegeven. De optie Query-URI met de titel URI Kopiëren is gemarkeerd.

2. Gegevens ophalen

In deze stap gebruikt u een script om eerst een tabel te maken met de opgegeven toewijzing en vervolgens de gegevens van een openbare blob in deze tabel te plaatsen.

  1. Kopieer het KQL-script uit de Fabric voorbeelden opslagplaats op GitHub

    Schermopname van GitHub-opslagplaats met het KQL-script voor het NYC Taxi-demo-notebook. Het kopieerpictogram is gemarkeerd.

  2. Blader naar uw KQL-database.

  3. Selecteer Query met code om een leeg tabblad in de NYCTaxiDB_queryset te openen.

  4. Plak het KQL-script uit stap 1. en selecteer de knop Uitvoeren .

    De eerste query maakt de tabel en schematoewijzing aan. De uitvoer van deze query geeft de tabel- en mappingcreatie-informatie weer, inclusief het type opdracht en het resultaat van Voltooid wanneer het proces voltooid is. Met de tweede query worden uw gegevens geladen. Het laden van gegevens kan enkele minuten duren.

    Schermopname van het querysetvenster met de voltooide status van de tabeltoewijzing en gegevensopname.

  5. Vernieuw de queryset en selecteer Tabellen om een overzicht te zien van de zojuist gemaakte tabel met de naam trips2. Hier kunt u het tabelschema uitvouwen, een voorbeeld van de gegevens bekijken en query-inzichten bekijken.

    Schermopname van het tabblad Tabellen met de tabel trips2.

3. Download het NYC Taxi Demo Notebook

Gebruik een voorbeeldnotebook om een query uit te voeren en de voorbeeldgegevens te visualiseren die u in uw KQL-database hebt geladen.

  1. Open de opslagplaats fabric-voorbeelden op GitHub en download de NYC Taxi KQL Notebook..

    Schermopname van GitHub-repository met het demo-notebook NYC Taxi. De optie met de titel Raw is gemarkeerd.

  2. Download het notitieblok lokaal naar uw apparaat.

    Opmerking

    Het notitieblok moet worden opgeslagen in de .ipynb bestandsindeling.

4. Het notitieblok importeren

De rest van deze werkstroom maakt gebruik van Kqlmagic om de gegevens in uw KQL-database op te vragen en te visualiseren.

  1. Selecteer Importeren>Notebook<vanuit deze computer in uw werkruimte.

    Schermopname van itemopties in Data Engineering. Het item met de titel Import notebook is gemarkeerd.

  2. Selecteer Uploaden in het deelvenster Status importeren.

    Schermopname van het venster Importstatus. De knop uploaden is gemarkeerd.

  3. Selecteer het NYC Taxi KQL Notebook dat u in stap 3 hebt gedownload.

  4. Zodra het importeren is voltooid, selecteert u Ga naar de werkruimte en opent u dit notitieblok.

    Schermopname van het uploaden is voltooid en ga naar de werkruimte.

Voer het notebook uit

Selecteer de afspeelknop om elke cel opeenvolgend uit te voeren of selecteer de cel en druk op Shift+Enter. Herhaal deze stap voor elk pakket.

Opmerking

Wacht totdat het voltooiingscontrolemarkering wordt weergegeven voordat de volgende cel wordt uitgevoerd.

Schermopname van celblok met de importopdracht. De knop Afspelen is gemarkeerd.

Voer de resterende cellen sequentieel uit om een heatmap te maken van taxi's in NYC. Zie Een Jupyter Notebook- en Kqlmagic-extensie gebruiken om gegevens te analyseren voor meer informatie over Kqlmagic

  1. In de volgende cel worden alle ophaalopdrachten binnen de opgegeven geografische grens samengevoegd.

    Schermopname van codecel met aggregatiequery.

  2. Voer de volgende cel uit om een heatmap te tekenen van taxi's in NYC.

    Schermopname van codecel met query om heatmap te maken.

    In de resulterende heatmap ziet u dat de meeste taxi pick-ups zich in de lower Manhattan area bevinden. Daarnaast zijn er ook veel taxiritten op de luchthavens JFK en La Guardia.

    Schermopname van een notitieblok met een heatmap van het ophalen van taxi's in NYC.

6. De middelen opschonen

Schoon de items op die zijn gemaakt door te navigeren naar de werkruimte waarin ze zijn gemaakt.

  1. Beweeg de muisaanwijzer in uw werkruimte over het notitieblok dat u wilt verwijderen, selecteer het menu Meer [...] >Verwijderen.

    Schermopname van de werkruimte met de vervolgkeuzelijst van het NYC Taxi-notitieblok. De optie met de titel Verwijderen is gemarkeerd.

  2. Selecteer Verwijderen. U kunt uw notitieblok niet herstellen nadat u het hebt verwijderd.