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 źródła danych

Zapytania są uruchamiane w kontekście źródła danych. Skojarzone źródło 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 źródłem danych z klastra usługi Azure Data Explorer.

Wybierz kartę odpowiadającą żądanemu typowi źródła danych.

Baza danych KQL

1. Otwórz zestaw zapytań KQL.

2. Na stronie zapytania, w okienku po lewej stronie, pod Explorer i paskiem wyszukiwania, użyj przełącznika baz danych, by rozwinąć menu połączeń źródłowych.

   

3. Wybierz pozycję Dodaj źródło danych , a następnie wybierz pozycję centrum danych OneLake .

4. 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. Możesz też zamknąć okno centrum danych OneLake i użyć menu + Dodaj źródło danych, aby nawiązać połączenie z innym źródłem danych.

Klaster usługi Azure Data Explorer

1. Otwórz zestaw zapytań KQL.

2. W okienku po lewej stronie strony zapytania, w obszarze Explorer i paska wyszukiwania, użyj przełącznika bazy danych, aby rozwinąć menu połączeń z bazą danych.

   

3. Wybierz pozycję Dodaj źródło danych, a następnie wybierz pozycję Azure Data Explorer.

4. W obszarze Identyfikator URI połączenia wprowadź identyfikator URI klastra.

   Aby znaleźć identyfikator URI połączenia, przejdź do zasobu klastra w witrynie Azure Portal. Identyfikator URI połączenia to identyfikator URI znaleziony w sekcji Przegląd. Aby dodać bezpłatny przykładowy klaster, określ wartość "pomoc" jako identyfikator URI połączenia.

   

5. W obszarze Databasewybierz menu rozwijane, aby rozwinąć listę źródeł danych w klastrze, a następnie wybierz źródło danych.

6. Wybierz pozycję Połącz.

Poniżej nazwy źródła danych zostanie wyświetlona lista tabel skojarzonych z tym źródłem danych.

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ęzyka Kusto Query Language (KQL) do wykonywania zapytań dotyczących danych z dowolnych źródeł 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.

1. Napisz lub skopiuj zapytanie w górnym okienku zestawu zapytań KQL.

2. 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.

   

Interakcja ze źródłami danych

Eksplorator źródeł danych umożliwia przełączanie się między źródłami danych połączonymi z kartą zapytań, na której się znajdujesz.

W górnej części okienka Eksploratora źródeł danych w obszarze Explorer możesz użyć paska wyszukiwania, aby wyszukać określone źródło danych. Możesz również użyć przełącznika bazy danych poniżej paska wyszukiwania, aby rozwinąć menu połączeń ze źródłem danych. Wybierz źródło danych, którego chcesz użyć. Jeśli nazwa karty nie została wcześniej edytowana, zostanie ona automatycznie nazwana na podstawie źródła danych.

Okienko Eksploratora źródeł danych zawiera dwie sekcje. Górna sekcja zawiera listę wszystkich elementów w źródle danych, a dolna sekcja zawiera wszystkie dostępne źródła danych w zestawie zapytań.

Elementy w źródle danych

Górna sekcja Eksploratora źródeł danych zawiera wszystkie elementy uwzględnione w używanym źródle danych.

• Tabele
• Zmaterializowany widok
• Skróty
• Funkcje

Wybierz strzałkę > z lewej strony elementu, który chcesz rozwinąć. Aby wyświetlić więcej szczegółów, możesz rozwinąć listę klikając strzałkę > po lewej stronie elementów na kolejnych poziomach listy. Na przykład w obszarze Tabelewybierz strzałkę > z lewej strony tabeli, aby wyświetlić listę kolumn w tej tabeli.

Aby otworzyć menu akcji, umieść kursor na elemencie na rozwiniętej liście i wybierz menu Więcej akcji [...]. W menu są wyświetlane następujące opcje:

• Odświeżanie bazy danych
• Wyświetlanie profilu danych
• Wstaw: aby utworzyć i skopiować skrypt
• Pobieranie danych: aby dodać nowe źródło danych
• Tworzenie pulpitu nawigacyjnego
• Usuwanie tabeli

Różne akcje są dostępne dla różnych typów elementów.

Dostępne źródła danych

W dolnej sekcji Eksploratora źródeł danych są wyświetlane wszystkie dostępne źródła danych, które zostały dodane do zestawu zapytań.

Aby otworzyć menu akcji, umieść kursor nad nazwą źródła danych i wybierz menu Więcej akcji [...]. W menu są wyświetlane następujące opcje:

• Odświeżanie bazy danych
• Użyj tej bazy danych: przełącz, aby użyć tego źródła danych na obecnej zakładce.
• Zapytanie na nowej karcie: otwórz to źródło danych na nowej karcie w zestawie zapytań
• Usuń źródło: usuwa wszystkie bazy danych w tym źródle danych
• Usuń bazę danych: usuwa tylko wybraną bazę danych

Kopiuj zapytanie

Możesz skopiować i udostępnić utworzone zapytania.

1. W górnej części okna zapytania wybierz kartę Narzędzia główne .

2. 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.

3. Wybierz żądaną akcję z listy.

4. 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.

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 skojarzoną z każdą kartą, umożliwiając uruchamiać to samo zapytanie dotyczące danych w różnych bazach danych.

Kartami można zarządzać w następujący sposób:

• Zmień istniejące połączenie ze źródłem danych: w obszarze Explorer i na pasku wyszukiwania użyj przełącznika bazy danych, aby rozwinąć menu połączenia źródła danych.
• Zmień nazwę karty: obok nazwy karty wybierz ikonę ołówka .
• Dodaj nową kartę: po prawej stronie istniejących kart na pasku poleceń wybierz znak plus +. Różne karty można połączyć z różnymi źródłami danych.
• Więcej akcji: Po prawej stronie paska poleceń znajduje się karta menu z dodatkowymi opcjami, umożliwiająca zarządzanie wieloma kartami w zestawie zapytań.
• Zmień położenia kart: użyj gestów przeciągania i upuszczania.

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.

1. W górnej części okna zapytania wybierz kartę Narzędzia główne .

   

2. W okienku zapytania wybierz pozycję Eksportuj do pliku CSV.

3. Zapisz plik CSV lokalnie.

Usuwanie zestawu zapytań KQL

Aby usunąć zestaw zapytań KQL:

1. Wybierz obszar roboczy, w którym znajduje się zestaw zapytań KQL.

2. Umieść kursor na zestawie zapytań KQL, który chcesz usunąć. Wybierz pozycję Więcej [...], a następnie wybierz pozycję Usuń.

   

Następny krok

Dostosowywanie wyników w siatce wyników zestawu zapytań KQL