Udostępnij przez

Samouczek: używanie notesu Fabric z Kqlmagic do wykonywania zapytań dotyczących bazy danych KQL

Notatniki fabric umożliwiają tworzenie i udostępnianie dokumentów zawierających kod wykonywalny, równania, wizualizacje i tekst narracyjny. Jest to przydatne w wielu zadaniach, takich jak czyszczenie i przekształcanie danych, symulacja liczbowa, modelowanie statystyczne, wizualizacja danych i uczenie maszynowe.

Kqlmagic rozszerza możliwości jądra języka Python w Fabric notebooks, dzięki czemu można uruchamiać zapytania Kusto Query Language (KQL) natywnie z komórek notesu. Język Python i język KQL można połączyć w celu wykonywania zapytań i wizualizowania danych przy użyciu bogatej biblioteki Plotly zintegrowanej z operatorem renderowania .

Aby uzyskać więcej informacji na temat notatników, zobacz Jak używać notatników usługi Microsoft Fabric.

Z tego samouczka dowiesz się, jak używać języka Kqlmagic do uruchamiania zaawansowanych zapytań i wizualizacji z danych w bazie danych KQL. Używa wstępnie utworzonych zestawów danych i notesów zarówno w środowisku analizy Real-Time, jak i środowiskach inżynierii danych w usłudze Microsoft Fabric.

W tym poradniku nauczysz się, jak:

  • Tworzenie bazy danych KQL
  • Pobierz dane
  • Importowanie notesu za pomocą biblioteki Kqlmagic
  • Uruchamianie notesu

Wymagania wstępne

  • Obszar roboczy z włączoną pojemnością usługi Microsoft Fabric
  • Baza danych KQL z uprawnieniami do edycji

1. Tworzenie bazy danych KQL

W tym kroku utworzysz pustą bazę danych KQL o nazwie NYCTaxiDB w obszarze roboczym lub w istniejącym centrum zdarzeń.

  1. Wybierz swój obszar roboczy na pasku nawigacyjnym po lewej stronie.

  2. Wykonaj jedną z następujących czynności, aby rozpocząć tworzenie bazy danych KQL:

    • Wybierz Nowy element, a następnie Eventhouse. W polu Nazwa magazynu zdarzeń wprowadź NYCTaxiDB, a następnie wybierz pozycję Utwórz. Baza danych KQL jest generowana z tą samą nazwą.
    • W istniejącym budynku eventowym wybierz pozycję Databases. W obszarze Bazy danych KQL wybierz opcję +, w polu Nazwa bazy danych KQL wprowadź NYCTaxiDB, a następnie wybierz opcję Utwórz.

  3. Wybierz bazę danych NYCTaxiDB, rozwiń węzeł Szczegóły bazy danych, skopiuj URI zapytania i wklej go gdzieś, na przykład do notatnika, aby użyć go w późniejszym kroku.

    Zrzut ekranu przedstawiający kartę szczegółów bazy danych zawierającą szczegóły bazy danych. Wyróżniono opcję Identyfikator URI zapytania o nazwie Kopiuj identyfikator URI.

2. Pobieranie danych

W tym kroku użyjesz skryptu, aby najpierw utworzyć tabelę z określonym mapowaniem, a następnie pobrać dane z publicznego obiektu blob do tej tabeli.

  1. Skopiuj skrypt KQL z repozytorium przykładów usługi Fabric na GitHub

    Zrzut ekranu repozytorium GitHub przedstawiający skrypt KQL dla notatnika demo NYC Taxi. Ikona kopiowania jest wyróżniona.

  2. Przejdź do bazy danych KQL.

  3. Wybierz Zapytanie z kodem, aby otworzyć pustą kartę w NYCTaxiDB_queryset.

  4. Wklej skrypt KQL z kroku 1. i wybierz przycisk Uruchom .

    Pierwsze zapytanie tworzy tabelę i mapowanie schematu. Wyjście z tego zapytania przedstawia informacje o tworzeniu tabeli i mapowania, w tym typ polecenia i wynik Completed po zakończeniu. Drugie zapytanie ładuje dane. Ukończenie ładowania danych może potrwać kilka minut.

    Zrzut ekranu przedstawiający okno zestawu zapytań z ukończonym stanem mapowania tabeli i pozyskiwania danych.

  5. Odśwież zestaw zapytań i wybierz pozycję Tabele , aby wyświetlić przegląd nowo utworzonej tabeli o nazwie trips2. W tym miejscu możesz rozwinąć schemat tabeli, wyświetlić podgląd danych i wyświetlić szczegółowe informacje o zapytaniach.

    Zrzut ekranu karty Tabele pokazujący tabelę trips2.

3. Pobierz notatnik pokazowy NYC Taxi

Użyj przykładowego notesu, aby wykonać zapytanie i zwizualizować przykładowe dane załadowane w bazie danych KQL.

  1. Otwórz repozytorium Fabric samples na GitHub i pobierz NYC Taxi KQL Notebook.

    Zrzut ekranu przedstawiający repozytorium GitHub z notatnikiem demonstracyjnym NYC Taxi. Opcja Raw (Nieprzetworzone) jest wyróżniona.

  2. Pobierz notatnik lokalnie na swoje urządzenie.

    Uwaga / Notatka

    Notes musi być zapisany w .ipynb formacie pliku.

4. Importowanie notesu

Pozostała część tego przepływu pracy używa biblioteki Kqlmagic do wykonywania zapytań i wizualizowania danych w bazie danych KQL.

  1. W swojej przestrzeni roboczej, wybierz Importuj>Notebook<z tego komputera.

    Zrzut ekranu przedstawiający opcje elementów w inżynierii danych. Wyróżniono element o nazwie Import notatnika.

  2. W okienku Stan importu wybierz pozycję Przekaż.

    Zrzut ekranu przedstawiający okno Stan importu. Przycisk o nazwie Przekaż jest wyróżniony.

  3. Wybierz notes NYC Taxi KQL, który został pobrany w kroku 3.

  4. Po zakończeniu importowania wybierz pozycję Przejdź do obszaru roboczego i otwórz ten notes.

    Zrzut ekranu z informacją o pomyślnym zakończeniu uploadowania i przejściu do obszaru roboczego.

5. Uruchamianie notesu

Wybierz przycisk odtwarzania , aby uruchomić każdą komórkę sekwencyjnie, lub wybierz komórkę i naciśnij Shift+ Enter. Powtórz ten krok dla każdego pakietu.

Uwaga / Notatka

Poczekaj na wyświetlenie znacznika wyboru ukończenia przed uruchomieniem następnej komórki.

Zrzut ekranu przedstawiający blok komórek z poleceniem importu. Przycisk 'Odtwórz' jest wyróżniony.

Uruchom pozostałe komórki sekwencyjnie, aby utworzyć mapę cieplną pickupów taksówek w Nowym Jorku. Aby uzyskać więcej informacji na temat biblioteki Kqlmagic, zobacz Use a Jupyter Notebook and Kqlmagic extension to analyze data (Używanie notesu Jupyter Notebook i rozszerzenia Kqlmagic do analizowania danych)

  1. Poniższa komórka agreguje wszystkie odbiory w określonej granicy geograficznej.

    Zrzut ekranu przedstawiający komórkę kodu z zapytaniem agregacji.

  2. Uruchom następującą komórkę, aby narysować mapę cieplną pickupów taksówek NYC.

    Zrzut ekranu przedstawiający komórkę kodu z zapytaniem w celu utworzenia mapy cieplnej.

    Na wynikowej mapie cieplnej widać, że większość pickupów taksówkarzy znajduje się w dolnej części Manhattanu. Ponadto na lotnisku JFK i La Guardia jest również wiele pickupów taksówkarskich.

    Zrzut ekranu przedstawiający notatnik z mapą cieplną odbiorów taksówek w Nowym Jorku.

6. Czyszczenie zasobów

Wyczyść utworzone elementy, przechodząc do obszaru roboczego, w którym zostały utworzone.

  1. W obszarze roboczym umieść kursor nad notesem, który chcesz usunąć, wybierz menu Więcej [...] >Usuń.

    Zrzut ekranu przedstawiający obszar roboczy z menu rozwijanym notesu NYC Taxi. Wyróżniona jest opcja o nazwie Usuń.

  2. Wybierz Usuń. Nie można odzyskać notesu po jego usunięciu.

Treści powiązane

  • Last updated on