Korzystanie z narzędzia Kusto.explorer

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Kusto.Explorer to aplikacja klasyczna, która umożliwia eksplorowanie danych przy użyciu języka Kusto Query Language (KQL) w intuicyjnym interfejsie. W tym przewodniku wyjaśniono, jak używać trybów wyszukiwania i zapytań, udostępniać zapytania oraz zarządzać klastrami, bazami danych i tabelami w celu zoptymalizowanej analizy danych.

Tryb wyszukiwania++

Tryb wyszukiwania++ umożliwia wyszukiwanie terminu przy użyciu składni wyszukiwania w co najmniej jednej tabeli.

1. Na karcie Narzędzia główne na liście rozwijanej Zapytanie wybierz pozycję Search++.

2. Wybierz pozycję Wiele tabel.

3. W obszarze Wybierz tabele określ tabele do wyszukania, a następnie wybierz OK.

4. W polu edycji wprowadź frazę wyszukiwania i wybierz pozycję Przejdź.

   Mapa cieplna tabeli i kratki czasowej pokazuje, gdzie pojawiają się pojęcia.

   

5. Wybierz komórkę w siatce, a następnie wybierz pozycję Wyświetl szczegóły , aby wyświetlić odpowiednie wpisy w okienku wyników.

   

Tryb zapytania

Narzędzie Kusto.Explorer oferuje zaawansowany tryb zapytań, który umożliwia pisanie, edytowanie i uruchamianie zapytań wbudowanych. Tryb zapytania obejmuje wyróżnianie składni i funkcję IntelliSense, dzięki czemu szybko poprawisz swoją wiedzę na temat języka zapytań Kusto.

W tej sekcji wyjaśniono, jak uruchamiać podstawowe zapytania w usłudze Kusto.Explorer i dodawać parametry do zapytań.

Zapytania podstawowe

Jeśli masz dzienniki tabeli, możesz rozpocząć ich eksplorowanie:

StormEvents | count 

Gdy kursor znajduje się w tym wierszu, jest szary. Wybierz F5 , aby uruchomić zapytanie.

Oto kilka przykładowych zapytań:

// Take 10 lines from the table. This is useful to get familiar with the data.
StormEvents | take 10 

// Filter by EventType == 'Flood' and State == 'California' (where =~ means case insensitive). 
// Take a sample of 10 lines.
StormEvents 
| where EventType == 'Flood' and State =~ 'California'
| take 10

Dowiedz się więcej o języku zapytań Kusto w Kusto Query Language.

Parametryzacja zapytań po stronie klienta

Jeśli używasz tej samej wartości w wielu zapytaniach lub kartach, może być kłopotliwe zmieniać ją we wszystkich miejscach jej użycia. Kusto.Explorer umożliwia wygodne używanie parametrów zapytania. Parametry zapytania są współużytkowane na kartach, dzięki czemu można je łatwo użyć. Parametry są przedstawiane w nawiasach klamrowych ({}). Na przykład {parameter1}.

Definiowanie i edytowanie parametrów zapytania:

Można użyć wielu zestawów parametrów wymienionych w polu kombi Zestaw parametrów . Wybierz pozycję Dodaj nowy lub Usuń bieżący , aby zarządzać zestawami parametrów.

Udostępnianie zapytań i wyników

W usłudze Kusto.Explorer udostępnij zapytania i wyniki pocztą e-mail. Utwórz linki głębokie, aby otworzyć i uruchomić zapytanie w przeglądarce.

Udostępnianie zapytań i wyników pocztą e-mail

Udostępnianie zapytań i wyników zapytań pocztą e-mail w usłudze Kusto.Explorer.

Głębokie łączenie zapytań

Możesz utworzyć identyfikator URI, który po otwarciu w przeglądarce otwiera aplikację Kusto.Explorer lokalnie i uruchamia określone zapytanie w określonej bazie danych Kusto.

Tworzenie linku głębokiego

Najprostszym sposobem utworzenia linku głębokiego jest napisanie zapytania w Kusto.Explorer, a następnie użycie Query and results to Clipboard do skopiowania zapytania, w tym linku głębokiego i wyników, do schowka. Następnie możesz udostępnić go pocztą e-mail.

Po skopiowaniu do wiadomości e-mail kilka linków do wykonania jest wyświetlanych w małej czcionki. Na przykład:

Link internetowy otwiera zapytanie w usłudze Azure Data Explorer. Link pulpitu to link bezpośredni. Spowoduje to otwarcie zapytania w usłudze Kusto.Explorer i odpowiednie ustawienie kontekstu.

Jeśli przeniesiesz link do wiadomości e-mail i naciśnij CTRL+K, możesz zobaczyć rzeczywisty adres URL.

Linki głębokie i zapytania sparametryzowane

Zapytania parametryzowane można używać z łączeniem głębokim.

1. Utwórz zapytanie, które ma zostać utworzone jako zapytanie parametryczne (na przykład KustoLogs | where Timestamp > ago({Period}) | count)

Ograniczenia

Zapytania są ograniczone do ~2000 znaków ze względu na ograniczenia przeglądarki, serwery proxy HTTP i narzędzia, które weryfikują linki, takie jak Microsoft Outlook. Ograniczenie jest przybliżone, ponieważ zależy od długości nazwy klastra i bazy danych. Aby uzyskać więcej informacji, zobacz https://support.microsoft.com/kb/208427.

Aby zmniejszyć prawdopodobieństwo osiągnięcia limitu znaków, zobacz Coraz krótsze linki.

Uzyskiwanie krótszych łączy

Zapytania mogą stać się długie. Aby zmniejszyć prawdopodobieństwo przekroczenia maksymalnej długości, użyj String Kusto.Data.Common.CslCommandGenerator.EncodeQueryAsBase64Url(string query) metody w bibliotece klienta Kusto. Ta metoda tworzy bardziej kompaktową wersję zapytania. Krótszy format jest również rozpoznawany przez narzędzie Kusto.Explorer.

Aby zapytanie było bardziej kompaktowe, zastosuj następującą transformację:

 UrlEncode(Base64Encode(gzip(original query)))

Argumenty wiersza polecenia kusto.Explorer

Argumenty wiersza polecenia umożliwiają narzędziu wykonywanie większej liczby funkcji podczas uruchamiania, takich jak ładowanie skryptu i nawiązywanie połączenia z klastrem. Argumenty wiersza polecenia nie zastępują jednak żadnych funkcji kusto.Explorer.

Argumenty wiersza polecenia są częścią adresu URL używanego do otwierania aplikacji, podobnie do głębokiego linkowania zapytań.

Składnia argumentu wiersza polecenia

Narzędzie Kusto.Explorer obsługuje kilka argumentów wiersza polecenia przy użyciu tej składni (kolejność ma znaczenie):

[LocalScriptFile] [QueryString]

Argumenty wiersza polecenia

Argumenty tworzenia zapytań

Przykład

Kusto.Explorer.exe c:\temp\script.kql "uri=https://help.kusto.windows.net/Samples;Fed=true&name=Samples"

Kusto.Explorer.exe c:\temp\script.kql "uri=https://<baseaddress>/groups/<GroupID>/databases/<DatabaseID>"

Zarządzanie bazami danych, tabelami lub podmiotami zabezpieczeń autoryzowanymi przez funkcję

1. Aby wyświetlić listę autoryzowanych podmiotów zabezpieczeń, otwórz panel Połączenia, kliknij prawym przyciskiem myszy jednostkę docelową i wybierz pozycję Zarządzaj autoryzowanymi podmiotami zabezpieczeń bazy danych. Możesz również wybrać tę opcję z menu Zarządzanie.

   

2. Wybierz pozycję Dodaj podmiot zabezpieczeń , aby dodać autoryzowanego podmiotu zabezpieczeń.

3. Wprowadź główne dane, a następnie wybierz Dodaj główny.

   

4. Potwierdź dodanie uprawnionego przedstawiciela.

   

Aby usunąć autoryzowanego podmiotu, wybierz pozycję Usuń podmiot i potwierdź akcję.

Powiązana zawartość

• Skróty klawiaturowe Kusto.Explorer
• Opcje kusto.Explorer
• Rozwiązywanie problemów z narzędziem Kusto.Explorer
• Funkcje kodu Kusto.Explorer
• Dowiedz się więcej o języku Kusto Query Language (KQL)