Używanie parametrów na pulpitach nawigacyjnych usługi Azure Data Explorer

Parametry są używane jako bloki konstrukcyjne dla filtrów na pulpitach nawigacyjnych usługi Azure Data Explorer. Są one zarządzane w zakresie pulpitu nawigacyjnego i można je dodawać do zapytań w celu filtrowania danych prezentowanych przez podstawową wizualizację. Zapytanie może używać co najmniej jednego parametru.

W tym dokumencie opisano tworzenie i używanie parametrów i połączonych filtrów na pulpitach nawigacyjnych. Parametry mogą służyć do filtrowania wizualizacji pulpitu nawigacyjnego przez wybranie wartości parametrów na pasku filtru lub przy użyciu filtrów krzyżowych.

Przykłady zapytań używane w tym artykule są oparte na StormEvents tabeli w galerii przykładów.

Uwaga

Zarządzanie parametrami jest dostępne w trybie edycji dla edytorów pulpitów nawigacyjnych.

Wymagania wstępne

• Wizualizowanie danych przy użyciu pulpitów nawigacyjnych usługi Azure Data Explorer
• Uprawnienia edytora na pulpicie nawigacyjnym usługi Azure Data Explorer
• Pulpit nawigacyjny z wizualizacjami

Wyświetlanie listy parametrów

Aby wyświetlić listę wszystkich parametrów pulpitu nawigacyjnego, wybierz przycisk Parametry w górnej części pulpitu nawigacyjnego.

Tworzenie parametru

Aby utworzyć parametr:

1. Przełącz się z widoku do trybu edycji .

   

2. Wybierz przycisk Parametry w górnej części pulpitu nawigacyjnego.

   

3. Wybierz przycisk + Nowy parametr w górnej części okienka po prawej stronie.

4. Wypełnij odpowiednie właściwości parametru.

Obsługiwane właściwości

W okienku Dodawanie parametru skonfiguruj następujące właściwości:

Pole	Opis
Etykieta	Nazwa parametru wyświetlanego na pulpicie nawigacyjnym lub karcie edycji.
Typ parametru	Jeden z następujących parametrów: Wybór pojedynczy: w filtrze można wybrać tylko jedną wartość jako dane wejściowe dla parametru. Wybór wielokrotny: co najmniej jedną wartość można wybrać w filtrze jako dane wejściowe dla parametru. Zakres czasu: umożliwia tworzenie dodatkowych parametrów do filtrowania zapytań i pulpitów nawigacyjnych na podstawie czasu. Każdy pulpit nawigacyjny domyślnie ma selektor zakresu czasu. Dowolny tekst: nie ma żadnych wartości wypełnionych w filtrze. Użytkownik może wpisać wartość lub skopiować/wkleić wartość do pola tekstowego. Filtr przechowuje ostatnio używane wartości.
Nazwa zmiennej	Nazwa parametru, który ma być używany w zapytaniu. Porada: Tworzenie prefiksów nazw zmiennych z charakterystycznym znakiem, takim jak znak podkreślenia (_), ułatwia znajdowanie nazw podczas pisania zapytań.
Typ danych	Typ danych wartości parametrów.
Pokaż na stronach	Wybierz strony, na których będzie wyświetlany ten parametr. Opcja Zaznacz wszystko powoduje wyświetlenie parametru na wszystkich stronach.
Element źródłowy	Źródło wartości parametrów: Stałe wartości: Ręcznie wprowadzono wartości filtru statycznego. Zapytanie: Dynamicznie wprowadzane wartości przy użyciu zapytania KQL.
Wartość domyślna	Wartość domyślna filtru. Filtr będzie zawsze rozpoczynał się od wartości domyślnej podczas początkowego renderowania pulpitu nawigacyjnego.
Dodawanie wartości "Zaznacz wszystko"	Dotyczy tylko pojedynczego zaznaczenia i wielu typów parametrów wyboru. Służy do pobierania danych dla wszystkich wartości parametrów. Ta wartość powinna być wbudowana w zapytanie, aby zapewnić funkcjonalność. Aby uzyskać więcej przykładów tworzenia takich zapytań, zobacz Używanie parametru opartego na zapytaniach wielokrotnego wyboru.

Zarządzanie parametrami

Po wybraniu pozycji Parametry na górnym pasku możesz wyświetlić listę istniejących parametrów. Na każdej karcie parametrów wybierz widżet ołówka, aby edytować parametr, lub wybierz menu Więcej [...] do pozycji Duplikuj, Usuń lub przenieś parametr.

Na karcie parametrów można wyświetlić następujące wskaźniki:

• Nazwa wyświetlana parametru
• Nazwy zmiennych
• Liczba zapytań, w których użyto parametru
• Strony, do których jest przypięty parametr

Karty parametrów można porządkować przeciągając i upuszczając lub używając opcji Przenieś do > i wybierając nową lokalizację.

Używanie parametrów w zapytaniu

Parametr musi być używany w zapytaniu, aby filtr był odpowiedni dla tej wizualizacji zapytania. Po zdefiniowaniu można zobaczyć parametry na górnym pasku filtru strony >zapytania i w funkcji IntelliSense zapytań.

Uwaga

Jeśli parametr nie jest używany w zapytaniu, filtr pozostaje nieaktywny. Po dodaniu parametru do zapytania filtr staje się aktywny.

Typy parametrów

Obsługiwanych jest kilka typów parametrów pulpitu nawigacyjnego w następujący sposób:

• Domyślny parametr zakresu czasu
• Parametry o stałych wartościach z pojedynczym wyborem
• Parametry o stałej wartości wyboru wielokrotnego wyboru
• Parametry oparte na zapytaniach z pojedynczym wyborem
• Parametry oparte na zapytaniach wielokrotnego wyboru
• Parametry wolnego tekstu
• Parametry źródła danych

W poniższych przykładach opisano sposób używania parametrów w zapytaniu dla różnych typów parametrów.

Domyślny parametr zakresu czasu

Każdy pulpit nawigacyjny ma domyślnie parametr Zakres czasu . Jest on wyświetlany na pulpicie nawigacyjnym jako filtr tylko wtedy, gdy jest używany w zapytaniu. Użyj słów kluczowych _startTime parametrów i _endTime użyj domyślnego parametru zakresu czasu w zapytaniu, jak pokazano w poniższym przykładzie:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Po zapisaniu filtr zakresu czasu jest wyświetlany na pulpicie nawigacyjnym. Teraz można go użyć do filtrowania danych na karcie. Pulpit nawigacyjny można filtrować, wybierając z listy rozwijanej: Zakres czasu (ostatnie x minuty/godziny/dni) lub niestandardowy zakres czasu.

Parametry o stałych wartościach z pojedynczym wyborem

Stałe parametry wartości są oparte na wstępnie zdefiniowanych wartościach określonych przez użytkownika. W poniższym przykładzie pokazano, jak utworzyć pojedynczy parametr stałej wartości zaznaczenia.

Tworzenie parametru o stałych wartościach z jednym wyborem

1. Wybierz pozycję Parametry , aby otworzyć okienko Parametry i wybrać pozycję Nowy parametr.

2. Wypełnij szczegóły w następujący sposób:

   • Etykieta: Typ zdarzenia

   • Typ parametru: Wybór pojedynczy

   • Nazwa zmiennej: _eventType

   • Typ danych: Ciąg

   • Przypnij jako filtr pulpitu nawigacyjnego: zaznaczone

   • Źródło: Stałe wartości

     W tym przykładzie użyj następujących wartości:

     Wartość	Nazwa wyświetlana parametru
     Burza wiatru	Burza wiatru
     Grad	Grad
     Powodzie błyskawiczne	Powodzie błyskawiczne
     Susza	Susza
     Pogoda zimowa	Zimowa pogoda

   • Dodaj wybraną wartość: Niezaznaczone

   • Wartość domyślna: Wiatr burzy z piorunami

3. Wybierz pozycję Gotowe , aby utworzyć parametr.

Parametr można zobaczyć w okienku bocznym Parametry , ale nie są obecnie używane w żadnych wizualizacjach.

Używanie parametru stałych wartości pojedynczego zaznaczenia

1. Uruchom przykładowe zapytanie przy użyciu nowego parametru TypTope zdarzenia , używając nazwy zmiennej _eventType :

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType == _eventType
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Nowy parametr jest wyświetlany na liście parametrów w górnej części pulpitu nawigacyjnego.

2. Wybierz różne wartości, aby zaktualizować wizualizacje.

   

Parametry stałych wartości wielokrotnego wyboru

Parametry wartości stałej są oparte na wstępnie zdefiniowanych wartościach określonych przez użytkownika. W poniższym przykładzie pokazano, jak utworzyć i użyć parametru o stałej wartości wielokrotnego wyboru.

Tworzenie parametrów stałych wartości wielokrotnego wyboru

1. Wybierz pozycję Parametry , aby otworzyć okienko Parametry i wybierz pozycję Nowy parametr.

2. Wypełnij szczegóły, jak wspomniano w temacie Use a single-selection fixed-values parametru z następującymi zmianami:

   • Etykieta: Typ zdarzenia
   • Typ parametru: Wybór wielokrotny
   • Nazwa zmiennej: _eventType

3. Wybierz pozycję Gotowe , aby utworzyć parametr.

Nowe parametry można zobaczyć w okienku bocznym Parametry , ale nie są obecnie używane w żadnych wizualizacjach.

Używanie parametru wartości stałych wielokrotnego wyboru

1. Uruchom przykładowe zapytanie przy użyciu nowego parametru Typu zdarzenia przy użyciu zmiennej _eventType .

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Nowy parametr jest wyświetlany na liście parametrów w górnej części pulpitu nawigacyjnego.

2. Wybierz co najmniej jedną inną wartość, aby zaktualizować wizualizacje.

   

Parametry oparte na zapytaniach z jednym zaznaczeniem

Wartości parametrów opartych na zapytaniach są pobierane podczas ładowania pulpitu nawigacyjnego przez wykonanie zapytania parametru. W poniższym przykładzie pokazano, jak utworzyć i użyć pojedynczego parametru opartego na zapytaniach.

Tworzenie parametru opartego na zapytaniach z jednym wyborem

1. Wybierz pozycję Parametry , aby otworzyć okienko Parametry i wybierz pozycję Nowy parametr.

2. Wypełnij szczegóły, jak wspomniano w temacie Use a single-selection fixed-values parametru z następującymi zmianami:

   • Etykieta: stan

   • Nazwa zmiennej: _state

   • Źródło: Zapytanie

   • Źródło danych: StormEventsSample

   • Wybierz pozycję Edytuj zapytanie i wprowadź następujące zapytanie. Kliknij Gotowe.

     StormEvents
     | where StartTime between (_startTime.._endTime)
     | where EventType in (_eventType) or isempty(_eventType)
     | summarize TotalEvents = count() by State
     | top 5 by TotalEvents
     | project State
     

   • Wartość: Stan

   • Nazwa wyświetlana: Stan

   • Wartość domyślna: wybierz wartość domyślną

3. Wybierz pozycję Gotowe , aby utworzyć parametr.

Używanie parametru opartego na zapytaniach z jednym wyborem

1. Następujące przykładowe zapytanie z nowym parametrem State używa zmiennej _state :

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State == _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Nowy parametr jest wyświetlany na liście parametrów w górnej części pulpitu nawigacyjnego.

2. Wybierz różne wartości, aby zaktualizować wizualizacje.

Parametry oparte na zapytaniach wielokrotnego wyboru

Wartości parametrów opartych na zapytaniach pochodzą w czasie ładowania pulpitu nawigacyjnego przez wykonanie określonego zapytania przez użytkownika. W poniższym przykładzie pokazano, jak utworzyć parametr oparty na zapytaniach wielokrotnego wyboru:

Tworzenie parametru opartego na zapytaniach wielokrotnego wyboru

1. Wybierz pozycję Parametry , aby otworzyć okienko Parametry i wybierz pozycję + Nowy parametr.

2. 1. Wypełnij szczegóły, jak wspomniano w temacie Use a single-selection fixed-values parametru z następującymi zmianami:
   • Etykieta: stan
   • Typ parametru: Wybór wielokrotny
   • Nazwa zmiennej: _state

3. Wybierz pozycję Gotowe , aby utworzyć parametr.

Używanie parametru opartego na zapytaniach wielokrotnego wyboru

1. Poniższe przykładowe zapytanie używa nowego parametru State przy użyciu zmiennej _state .

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State in (_state) or isempty(_state)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Uwaga

   W tym przykładzie użyto opcji Wybierz wszystko , sprawdzając puste wartości za pomocą isempty() funkcji.

   Nowy parametr jest wyświetlany na liście parametrów w górnej części pulpitu nawigacyjnego.

2. Wybierz co najmniej jedną inną wartość, aby zaktualizować wizualizacje.

Parametry tekstu bezpłatnego

Parametry bezpłatnego tekstu nie zawierają żadnych wartości. Umożliwiają one wprowadzenie własnej wartości.

Tworzenie bezpłatnego parametru tekstowego

1. Wybierz pozycję Parametry , aby otworzyć okienko Parametry i wybierz pozycję + Nowy parametr.

2. Wypełnij szczegóły w następujący sposób:

   • Etykieta: stan
   • Typ parametru: Wolny tekst
   • Nazwa zmiennej: _state
   • Typ danych: Ciąg
   • Wartość domyślna: Brak wartości domyślnej

Używanie bezpłatnego parametru tekstowego

1. Uruchom przykładowe zapytanie przy użyciu nowego parametru State przy użyciu nazwy zmiennej _state :

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State contains _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

Parametry źródła danych

Po dodaniu źródeł danych do pulpitu nawigacyjnego możesz utworzyć parametr, który wybiera co najmniej jedno z dostępnych źródeł danych. Ten parametr może być używany w kafelkach i innych parametrach.

Tworzenie parametru źródła danych

1. Wybierz pozycję Parametry , aby otworzyć okienko Parametry i wybierz pozycję + Nowy parametr.

2. Wypełnij szczegóły w następujący sposób:

   • Etykieta: Źródło
   • Typ parametru: Źródło danych
   • Pokaż na stronach: Zaznacz wszystko
   • Wartości: Zaznacz wszystko
   • Wartość domyślna: StormEventsSample

3. Kliknij Gotowe.

Nowy parametr jest teraz widoczny na liście parametrów w górnej części pulpitu nawigacyjnego.

Używanie parametru źródła danych

1. Przejdź do zapytania nowego lub istniejącego kafelka.

2. W obszarze Źródło wybierz nazwę nowego parametru w obszarze Parametry źródła danych. W przypadku powyższego parametru wybierz pozycję Klaster.

3. Wybierz pozycję Zastosuj zmiany.

4. Użyj parametru Klaster , aby zmienić źródło danych dla tego połączonego zapytania.

Parametry filtrowania krzyżowego

Filtry krzyżowe umożliwiają wybranie wartości w jednej wizualizacji, a wszystkie wizualizacje pulpitu nawigacyjnego, takie jak wykresy liniowe lub punktowe, są filtrowane tak, aby pokazywały tylko powiązane dane. Użycie filtrów krzyżowych daje taki sam wynik, jak wybranie równoważnej wartości parametru na liście parametrów w górnej części pulpitu nawigacyjnego.

Definiowanie filtrów krzyżowych

Aby utworzyć filtr krzyżowy, należy włączyć opcję w wizualizacji, a następnie określić parametr używany do filtrowania danych.

1. Przejdź do zapytania kafelka, w którym chcesz dodać filtry krzyżowe.

2. Wybierz pozycję Wizualizacja.

3. W okienku po prawej stronie wybierz pozycję Interakcje, a następnie włącz filtry krzyżowe.

4. Opcjonalnie określ typ interakcji . Wartość domyślna to Punkt , w którym można wybrać wartość w wizualizacji. Aby wybrać zakres wartości, na przykład na wykresie czasowym, wybierz pozycję Przeciągnij.

5. Określ zarówno kolumnę, która jest używana do podania wartości, jak i parametru używanego do filtrowania zapytania.

   Ważne

   Kolumna i parametr muszą mieć ten sam typ danych.

Interakcja z danymi przy użyciu filtrowania krzyżowego

Po zdefiniowaniu filtru krzyżowego można go użyć do interakcji z danymi. W wizualizacjach, w których zdefiniowano filtry krzyżowe, możesz wybrać punkty danych i użyć ich wartości do filtrowania bieżącej strony pulpitu nawigacyjnego. W przypadku wizualizacji tabeli wybierz punkty danych, klikając prawym przyciskiem myszy odpowiednią komórkę, a następnie w menu kontekstowym wybierz pozycję Filtrowanie krzyżowe.

Filtr krzyżowy można zresetować, wybierając pozycję Resetuj w górnej części wizualizacji, w której została wybrana.

Używanie przeglądania szczegółowego jako parametrów pulpitu nawigacyjnego

Korzystając z przeglądania szczegółowego, możesz wybrać wartość w wizualizacji i użyć jej do filtrowania wizualizacji na stronie docelowej na tym samym pulpicie nawigacyjnym. Po otwarciu strony docelowej wartość jest wstępnie zaznaczona w odpowiednich filtrach. Wizualizacje na stronie, takie jak wykresy liniowe lub punktowe, są filtrowane tak, aby pokazywały tylko powiązane dane.

Definiowanie przeglądania szczegółowego

Aby utworzyć przeglądanie szczegółowe, należy najpierw włączyć je w wizualizacji, a następnie dodać co najmniej jedno przeglądanie szczegółowe zgodnie z potrzebami.

1. Edytuj wizualizację, w której chcesz dodać przeglądanie szczegółowe. Upewnij się, że wybrano kartę Wizualizacja .

2. W okienku po prawej stronie wybierz pozycję Interakcje, a następnie włącz przeglądanie szczegółowe.

   

3. W obszarze Przeglądanie szczegółowe wybierz pozycję Utwórz nowy i określ następujące informacje. Opcjonalnie wybierz pozycję Dodaj kolejną parę , aby dodać wiele parametrów dla strony docelowej. Powtórz ten krok, aby dodać przeglądanie szczegółowe do innych stron na bieżącym pulpicie nawigacyjnym przy użyciu różnych parametrów.

   Pole	Opis
   Strona docelowa	Co najmniej jedna strona docelowa do przeglądania szczegółowego przy użyciu zdefiniowanych parametrów.
   Kolumna	Kolumna wyniku zapytania, która ma być używana jako wartość parametru na stronie docelowej.
   Parametr	Parametr używany do filtrowania wizualizacji na stronie docelowej przy użyciu wartości kolumny.
   Uwagi	Opcjonalny krótki opis.

   Ważne

   Pary kolumn i parametrów muszą mieć ten sam typ danych.

Interakcja z danymi przy użyciu przeglądania szczegółowego

Po zdefiniowaniu przeglądania szczegółowego możesz użyć ich do interakcji z danymi. W tym celu w wizualizacjach lub tabelach, w których zdefiniowano przeglądanie szczegółowe, kliknij prawym przyciskiem myszy punkt danych, a następnie wybierz pozycję Przeglądanie szczegółowe na>stronie docelowej. Wartości z punktu danych będą używane jako parametry do filtrowania wizualizacji na stronie docelowej.

Aby powrócić do strony źródłowej, w prawym górnym rogu strony docelowej wybierz pozycję Resetuj. Wszystkie filtry przypisane przez przeglądanie szczegółowe zostaną zresetowane.

Używanie wyszukiwania filtrów dla filtrów z jednym i wieloma filtrami wyboru

W filtrach pojedynczego i wielokrotnego wyboru wpisz żądaną wartość. Filtr jest aktualizowany tak, aby pokazywał tylko wartości zgodne z terminem wyszukiwania.

Zawartość pokrewna

• Dostosowywanie wizualizacji pulpitu nawigacyjnego usługi Azure Data Explorer
• Pisanie zapytań język zapytań Kusto w internetowym interfejsie użytkownika