Wykonywanie zapytań dotyczących danych w zestawie zapytań KQL
Z tego artykułu dowiesz się, jak używać zestawu zapytań KQL. Zestaw zapytań KQL to element używany do uruchamiania zapytań, wyświetlania i dostosowywania wyników zapytań dotyczących danych z różnych źródeł danych, takich jak Eventhouse, baza danych KQL i inne.
Zestaw zapytań KQL używa język zapytań Kusto do tworzenia zapytań, a także obsługuje wiele funkcji SQL. Aby uzyskać więcej informacji na temat języka zapytań, zobacz język zapytań Kusto omówienie.
Wymagania wstępne
- Obszar roboczy z pojemnością z włączoną usługą Microsoft Fabric
- Baza danych KQL z uprawnieniami do edycji i danymi lub klaster i baza danych usługi Azure Data Explorer z uprawnieniami AllDatabaseAdmin.
Wybieranie bazy danych
Zapytania są uruchamiane w kontekście bazy danych. Skojarzona baza danych można zmienić w dowolnym momencie i zachować zapytania zapisane w edytorze zapytań. Zestaw zapytań KQL można skojarzyć z wieloma źródłami danych różnych typów, w tym bazą danych KQL lub bazą danych z klastra usługi Azure Data Explorer.
Wybierz kartę odpowiadającą żądanemu typowi bazy danych.
W okienku połączenia po lewej stronie zapytania w obszarze Eksplorator wybierz pozycję V , aby rozwinąć menu połączenia bazy danych.
W obszarze Połącz źródło wybierz pozycję OneLake data hub.
W wyświetlonym oknie centrum danych OneLake wybierz bazę danych KQL, aby nawiązać połączenie z zestawem zapytań KQL, a następnie wybierz pozycję Połącz. Alternatywnie zamknijokno centrum danych OneLake i użyj menu +Dodaj źródło danych, aby nawiązać połączenie z innym źródłem danych.
Lista tabel skojarzonych z tą bazą danych jest wyświetlana poniżej nazwy bazy danych w okienku połączenia.
Interakcja z bazami danych przy użyciu okienka połączenia
Okienko połączenia umożliwia przeglądanie i przełączanie się między bazami danych połączonymi z zestawem zapytań. W okienku połączenia w obszarze Baza danych wybierz pozycję V , aby rozwinąć menu połączeń bazy danych. Wybierz bazę danych, którą chcesz eksplorować. Okienko połączenia zawiera podział następujących elementów uwzględnionych w wybranej bazie danych:
- Tabele
- Zmaterializowany widok
- Skróty
- Funkcje
W okienku połączenia możesz sprawdzić, jakie elementy są zawarte w każdej sekcji. Aby otworzyć menu akcji, umieść kursor nad elementem i wybierz menu Więcej [...]. Menu udostępnia opcje:
- Odświeżanie danych
- Wyświetlanie profilu danych
- Wstaw , aby utworzyć skrypt i wkleić go do edytora zapytań
- Usuń
Różne akcje są dostępne dla różnych typów elementów.
Pisanie zapytania
Teraz, gdy masz połączenie ze źródłem danych, możesz uruchamiać zapytania dotyczące tych danych. Zestaw zapytań KQL używa język zapytań Kusto (KQL) do wykonywania zapytań dotyczących danych z dowolnych baz danych, do których masz dostęp. Aby dowiedzieć się więcej na temat języka KQL, zobacz język zapytań Kusto omówienie.
W poniższych przykładach są używane dane, które są publicznie dostępne pod adresem https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.
Napisz lub skopiuj zapytanie w górnym okienku zestawu zapytań KQL.
Wybierz przycisk Uruchom lub naciśnij Shift+Enter, aby uruchomić zapytanie.
Wynikowe dane wyjściowe zapytania są wyświetlane w siatce wyników, która jest wyświetlana poniżej okienka zapytania. Zwróć uwagę na zielony znacznik wyboru wskazujący, że zapytanie zostało ukończone pomyślnie i czas użyty do obliczenia wyników zapytania.
Zarządzanie kartami zestawu zapytań
W zestawie zapytań KQL można utworzyć wiele kart. Każda karta może być skojarzona z inną bazą danych KQL i umożliwia zapisywanie zapytań do późniejszego użycia lub udostępniania innym osobom w celu współpracy nad eksploracją danych. Możesz również zmienić bazę danych KQL skojarzona z dowolną kartą, umożliwiając uruchamianie tego samego zapytania dotyczącego danych w różnych stanach.
- Dodaj nową kartę: wybierz znak plus + po prawej stronie istniejących kart. Różne karty można połączyć z różnymi bazami danych.
- Zmień nazwę karty: wybierz ikonę ołówka obok nazwy karty.
- Zmienia położenie karty: Zmień położenia kart przy użyciu gestów przeciągania i upuszczania.
- Zmień istniejące połączenie bazy danych: w obszarze Eksplorator wybierz istniejące połączenie bazy danych, aby otworzyć centrum danych.
Po prawej stronie paska poleceń znajduje się menu z dodatkowymi akcjami do zarządzania wieloma kartami w zestawie zapytań.
Kopiuj zapytanie
Możesz skopiować i udostępnić utworzone zapytania.
W górnej części okna zapytania wybierz kartę Narzędzia główne .
W okienku zapytania wybierz pozycję Kopiuj zapytanie.
W poniższej tabeli przedstawiono wiele opcji kopiowania zapytania.
Akcja opis Kopiuj zapytanie Skopiuj tekst zapytania. Łącze do schowka Skopiuj link bezpośredni, którego można użyć do uruchomienia zapytania. Łączenie i wykonywanie zapytań do schowka Skopiuj link, którego można użyć do uruchomienia zapytania i tekstu zapytania. Łączenie, wykonywanie zapytań i wyników w schowku Skopiuj link, który może służyć do uruchamiania zapytania, tekstu zapytania i wyników zapytania. Kopiowanie wyników Skopiuj wyniki zapytania. Wybierz żądaną akcję z powyższej tabeli.
Wklej te informacje, aby je edytować lub udostępnić, na przykład w programie Microsoft Word, Microsoft Teams lub Outlook.
Ważne
Użytkownik, który otrzymuje link zapytania, musi mieć uprawnienia do wyświetlania danych bazowych, aby wykonać zapytanie i wyświetlić wyniki.
Eksportowanie danych zapytania jako pliku CSV
Zamiast po prostu kopiować wklejanie danych wyjściowych zapytania, możesz również wyeksportować wyniki zapytania.
Jest to jednorazowa metoda eksportowania pliku CSV zawierającego wyniki zapytania.
W górnej części okna zapytania wybierz kartę Narzędzia główne .
W okienku zapytania wybierz pozycję Eksportuj do pliku CSV.
Zapisz plik CSV lokalnie.
Usuwanie zestawu zapytań KQL
Aby usunąć zestaw zapytań KQL:
Wybierz obszar roboczy, w którym znajduje się zestaw zapytań KQL.
Umieść kursor na zestawie zapytań KQL, który chcesz usunąć. Wybierz pozycję Więcej [...], a następnie wybierz pozycję Usuń.
