Tworzenie i uruchamianie notesu za pomocą biblioteki Kqlmagic

Kqlmagic to polecenie, które rozszerza możliwości jądra języka Python w notesach usługi Azure Data Studio. Język zapytań Języka Python i render Środowisko Kqlmagic zapewnia korzyści z notesów, analizy danych i zaawansowanych funkcji języka Python w tej samej lokalizacji. Obsługiwane źródła danych z biblioteką Kqlmagic obejmują dzienniki usług Azure Data Explorer, Application Insights i Azure Monitor.

W tym artykule pokazano, jak utworzyć i uruchomić notes w narzędziu Azure Data Studio przy użyciu rozszerzenia Kqlmagic dla klastra usługi Azure Data Explorer, dziennika usługi Application Insights i dzienników usługi Azure Monitor.

Wymagania wstępne

• Azure Data Studio
• Python

Instalowanie i konfigurowanie biblioteki Kqlmagic w notesie

Kroki opisane w tej sekcji są uruchamiane w notesie usługi Azure Data Studio.

1. Utwórz nowy notes i zmień jądro na Python 3.

   

2. Jeśli pakiety wymagają aktualizacji, może zostać wyświetlony monit o uaktualnienie pakietów języka Python.

   

3. Zainstaluj bibliotekę Kqlmagic:

   import sys
   !{sys.executable} -m pip install Kqlmagic --no-cache-dir --upgrade
   

   Sprawdź, czy jest zainstalowany:

   import sys
   !{sys.executable} -m pip list
   

   

4. Załaduj bibliotekę Kqlmagic:

   %reload_ext Kqlmagic
   

   Uwaga

   Jeśli ten krok zakończy się niepowodzeniem, zamknij plik i otwórz go ponownie.

   

5. Możesz sprawdzić, czy plik Kqlmagic jest poprawnie załadowany, przeglądając dokumentację pomocy lub sprawdzając wersję.

   %kql --help "help"
   

   Uwaga

   Jeśli Samples@help zostanie wyświetlone pytanie o hasło, możesz pozostawić je puste i nacisnąć Enter.

   

   Aby sprawdzić, która wersja programu Kqlmagic jest zainstalowana, uruchom poniższe polecenie.

   %kql --version
   

Narzędzie Kqlmagic z klastrem usługi Azure Data Explorer

W tej sekcji opisano sposób uruchamiania analizy danych przy użyciu biblioteki Kqlmagic z klastrem usługi Azure Data Explorer.

Ładowanie i uwierzytelnianie usługi Kqlmagic dla usługi Azure Data Explorer

1. Sprawdź, czy jądro ma ustawioną wartość Python3.

   

2. Załaduj bibliotekę Kqlmagic:

   %reload_ext Kqlmagic
   

   

3. Połącz się z klastrem i uwierzytelnij:

   %kql azureDataExplorer://code;cluster='help';database='Samples'
   

   Uwaga

   Jeśli używasz własnego klastra ADX, musisz uwzględnić region w parametry połączenia w następujący sposób:

   %kql azuredataexplorer://code;cluster='mycluster.westus';database='mykustodb' Logowanie urządzenia służy do uwierzytelniania. Skopiuj kod z danych wyjściowych i wybierz pozycję Uwierzytelnij , co spowoduje otwarcie przeglądarki, w której należy wkleić kod. Po pomyślnym uwierzytelnieniu możesz wrócić do usługi Azure Data Studio, aby kontynuować pracę z resztą skryptu.

   

Wykonywanie zapytań i wizualizowanie dla usługi Azure Data Explorer

Wykonywanie zapytań o dane przy użyciu operatora renderowania i wizualizowanie danych przy użyciu biblioteki plotly. To zapytanie i wizualizacja udostępnia zintegrowane środowisko korzystające z natywnego języka KQL.

1. Przeanalizuj 10 najważniejszych zdarzeń burzy według stanu i częstotliwości:

   %kql StormEvents | summarize count() by State | sort by count_ | limit 10
   

   Jeśli znasz język zapytań Kusto (KQL), możesz wpisać zapytanie po %kql.

   

2. Wizualizowanie wykresu osi czasu:

   %kql StormEvents \
   | summarize event_count=count() by bin(StartTime, 1d) \
   | render timechart title= 'Daily Storm Events'
   

   

3. Przykład zapytania wielowierszowego przy użyciu polecenia %%kql.

   %%kql
   StormEvents
   | summarize count() by State
   | sort by count_
   | limit 10
   | render columnchart title='Top 10 States by Storm Event count'
   

   

Kqlmagic z usługą Application Insights

Ładowanie i uwierzytelnianie usługi Kqlmagic dla usługi Application Insights

1. Sprawdź, czy jądro ma ustawioną wartość Python3.

   

2. Załaduj bibliotekę Kqlmagic:

   %reload_ext Kqlmagic
   

   

   Uwaga

   Za każdym razem, gdy tworzysz nowy notes w narzędziu Azure Data Studio, musisz załadować rozszerzenie Kqlmagic.

3. Nawiązywanie połączenia i uwierzytelnianie.

   Najpierw musisz wygenerować klucz interfejsu API dla zasobu usługi Application Insights. Następnie użyj identyfikatora aplikacji i klucza interfejsu API, aby nawiązać połączenie z usługą Application Insights z notesu:

   %kql appinsights://appid='DEMO_APP';appkey='DEMO_KEY'
   

Wykonywanie zapytań i wizualizowanie w usłudze Application Insights

Wykonywanie zapytań o dane przy użyciu operatora renderowania i wizualizowanie danych przy użyciu biblioteki plotly. To zapytanie i wizualizacja udostępnia zintegrowane środowisko korzystające z natywnego języka KQL.

1. Pokaż widoki stron:

   %%kql
   pageViews
   | limit 10
   

   

   Uwaga

   Użyj myszy, aby przeciągnąć obszar wykresu, aby powiększyć określoną datę.

2. Pokaż widoki strony na wykresie osi czasu:

   %%kql
   pageViews
   | summarize event_count=count() by name, bin(timestamp, 1d)
   | render timechart title= 'Daily Page Views'
   

   

Kqlmagic z dziennikami usługi Azure Monitor

Ładowanie i uwierzytelnianie usługi Kqlmagic dla dzienników usługi Azure Monitor

1. Sprawdź, czy jądro ma ustawioną wartość Python3.

   

2. Załaduj bibliotekę Kqlmagic:

   %reload_ext Kqlmagic
   

   

   Uwaga

   Za każdym razem, gdy tworzysz nowy notes w narzędziu Azure Data Studio, musisz załadować rozszerzenie Kqlmagic.

3. Łączenie i uwierzytelnianie:

   %kql loganalytics://workspace='DEMO_WORKSPACE';appkey='DEMO_KEY';alias='myworkspace'
   

   

Wykonywanie zapytań i wizualizowanie dzienników usługi Azure Monitor

Wykonywanie zapytań o dane przy użyciu operatora renderowania i wizualizowanie danych przy użyciu biblioteki plotly. To zapytanie i wizualizacja udostępnia zintegrowane środowisko korzystające z natywnego języka KQL.

1. Wyświetl wykres osi czasu:

   %%kql
   KubeNodeInventory
   | summarize event_count=count() by Status, bin(TimeGenerated, 1d)
   | render timechart title= 'Daily Kubernetes Nodes'
   

   

Następne kroki

Dowiedz się więcej o notesach i Kqlmagic:

• Rozszerzenie Kusto (KQL) dla usługi Azure Data Studio (wersja zapoznawcza)
• Tworzenie i uruchamianie notesu Kusto (KQL) (wersja zapoznawcza)
• Analizowanie danych w usłudze Azure Data Explorer przy użyciu notesu Jupyter Notebook i rozszerzenia Kqlmagic
• Rozszerzenie (Magic) do notesów Jupyter Notebook i laboratorium Jupyter, które umożliwia korzystanie z notesu podczas pracy z danymi usługi Kusto Application Insights i logAnalytics.
• Kqlmagic
• Jak używać notesów w narzędziu Azure Data Studio