Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dodaj parametry do zapytań Kusto Query Language (KQL), aby filtrować dane wyświetlane w wizualizacjach Real-Time Dashboard. Zapytanie może używać co najmniej jednego parametru.
Wymagania wstępne
- Zakończenie tworzenia i zarządzania parametrami Real-Time Dashboard.
- Pulpit wykorzystujący tabelę StormEvents w danych z analizy pogody z galerii próbek.
Używanie parametrów w zapytaniu
Parametr musi być używany w zapytaniu przed wpływem filtru na wizualizację. Po zdefiniowaniu parametru można go zobaczyć na pasku filtru na stronie Zapytanie i w zapytaniu IntelliSense.
Uwaga
Jeśli zapytanie nie używa parametru, filtr pozostaje nieaktywny. Po dodaniu parametru do zapytania filtr staje się aktywny.
Typy parametrów
Pulpit nawigacyjny obsługuje następujące typy parametrów:
- Domyślny parametr zakresu czasu
- Parametry stałych wartości z jednym wyborem
- Parametry stałych wartości wielokrotnego wyboru
- Parametry oparte na zapytaniach z jednym wyborem
- Parametry oparte na zapytaniach wielokrotnego wyboru
- Parametry tekstu wolnego
- 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 domyślnie zawiera parametr Zakres czasu . Jest on wyświetlany jako filtr tylko wtedy, gdy używasz go w zapytaniu. Użyj słów kluczowych _startTime i _endTime, aby zastosować domyślny parametr przedziału czasu, jak pokazano w poniższym przykładzie:
StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents
Po zapisaniu zapytania na pulpicie nawigacyjnym zostanie wyświetlony filtr zakresu czasu. Następnie możesz filtrować wizualizację, wybierając wstępnie ustawiony zakres czasu lub wybierając pozycję Niestandardowy zakres czasu.
Parametry o stałych wartościach jednokrotnego wyboru
Stałe parametry wartości są oparte na wstępnie zdefiniowanych wartościach. W poniższym przykładzie pokazano, jak utworzyć parametr z pojedynczym wyborem i stałą wartością.
Tworzenie parametru o stałych wartościach z jednym wyborem
Wybierz pozycję Parametry , aby otworzyć okienko Parametry , a następnie wybierz pozycję Nowy parametr.
Wprowadź następujące informacje:
Etykieta: Typ zdarzenia
Typ parametru: wybór pojedynczy
Nazwa zmiennej:
_eventTypeTyp danych: Ciąg
Przypnij jako filtr panelu: Wybrano
Źródło: Stałe wartości
W tym przykładzie użyj następujących wartości:
Wartość Nazwa wyświetlana parametru Wiatr i burza Wiatr związany z burzą Grad Grad Powodzia błyskawiczna Powodzie błyskawiczne Susza Susza Zimowa pogoda Pogoda zimowa Dodaj wartość Zaznacz wszystko: Niezaznaczone
Wartość domyślna: Burza Wiatru z piorunami
Wybierz pozycję Gotowe , aby utworzyć parametr.
Parametr zostanie wyświetlony w okienku Parametry , ale nie używasz go jeszcze w żadnej wizualizacji.
Używanie parametru o stałych wartościach z jednym wyborem
Uruchom przykładowe zapytanie, które używa nowego parametru typu zdarzenia przy użyciu nazwy zmiennej
_eventType:StormEvents | where StartTime between (_startTime.._endTime) | where EventType == _eventType | summarize TotalEvents = count() by State | top 5 by TotalEventsNowy parametr pojawi się na liście parametrów w górnej części pulpitu nawigacyjnego.
Wybierz różne wartości, aby zaktualizować wizualizacje.
Parametry wielokrotnego wyboru o stałych wartościach
Stałe parametry wartości są oparte na wstępnie zdefiniowanych wartościach. W poniższym przykładzie pokazano, jak utworzyć i użyć parametru o stałej wartości wielokrotnego wyboru.
Utwórz parametr o stałych wartościach z możliwością wielokrotnego wyboru
Wybierz pozycję Parametry , aby otworzyć okienko Parametry , a następnie wybierz pozycję Nowy parametr.
Wypełnij szczegóły zgodnie z opisem w sekcji Tworzenie parametru jednokrotnego wyboru o stałych wartościach, z następującymi zmianami:
- Etykieta: Typ zdarzenia
- Typ parametru: wybór wielokrotny
-
Nazwa zmiennej:
_eventType
Wybierz pozycję Gotowe , aby utworzyć parametr.
Nowy parametr zostanie wyświetlony w okienku Parametry , ale nie używasz go jeszcze w żadnej wizualizacji.
Użyj parametru wielokrotnego wyboru ze stałymi wartościami
Uruchom przykładowe zapytanie, które używa nowego parametru typu zdarzenia i zmiennej
_eventType.StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | summarize TotalEvents = count() by State | top 5 by TotalEventsNowy parametr pojawi się na liście parametrów w górnej części pulpitu nawigacyjnego.
Wybierz co najmniej jedną inną wartość, aby zaktualizować wizualizacje.
Parametry oparte na zapytaniu z możliwością pojedynczego wyboru
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 wyboru, opartego na zapytaniach parametru.
Aby użyć parametru opartego na zapytaniach jako filtra potomnego, którego wartości zależą od innego parametru, zobacz Utwórz parametry kaskadowe.
Tworzenie parametru opartego na zapytaniach z jednym wyborem
Wybierz pozycję Parametry , aby otworzyć okienko Parametry , a następnie wybierz pozycję Nowy parametr.
Wypełnij szczegóły zgodnie z opisem w sekcji Tworzenie parametru jednokrotnego wyboru o stałych wartościach, 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. Wybierz pozycję Gotowe.
StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | summarize TotalEvents = count() by State | top 5 by TotalEvents | project StateWartość: stan
Nazwa wyświetlana: Stan
Wartość domyślna: wybierz wartość domyślną
Wybierz pozycję Gotowe , aby utworzyć parametr.
Używanie parametru opartego na zapytaniach z jednym wyborem
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 TotalEventsNowy parametr pojawi się na liście parametrów w górnej części pulpitu nawigacyjnego.
Wybierz różne wartości, aby zaktualizować wizualizacje.
Parametry oparte na zapytaniach wielokrotnego wyboru
Wartości parametrów oparte na zapytaniach pochodzą z uruchamiania zapytania określonego przez użytkownika podczas ładowania pulpitu nawigacyjnego. W poniższym przykładzie pokazano, jak utworzyć parametr oparty na zapytaniach wielokrotnego wyboru.
Tworzenie parametru opartego na zapytaniach wielokrotnego wyboru
Wybierz pozycję Parametry , aby otworzyć okienko Parametry , a następnie wybierz pozycję + Nowy parametr.
Wprowadź szczegóły zgodnie z opisem w temacie Tworzenie parametru opartego na zapytaniach z jednym wyborem z następującymi zmianami:
- Etykieta: stan
- Typ parametru: wybór wielokrotny
-
Nazwa zmiennej:
_state
Wybierz pozycję Gotowe , aby utworzyć parametr.
Używanie parametru opartego na zapytaniach wielokrotnego wyboru
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 TotalEventsUwaga
W tym przykładzie użyto opcji Wybierz wszystko , sprawdzając puste wartości za pomocą
isempty()funkcji .Nowy parametr pojawi się na liście parametrów w górnej części pulpitu nawigacyjnego.
Wybierz co najmniej jedną inną wartość, aby zaktualizować wizualizacje.
Parametry tekstu wolnego
Parametry tekstu bezpłatnego nie zawierają żadnych wartości. Umożliwiają one wprowadzenie własnej wartości.
Tworzenie bezpłatnego parametru tekstowego
- Wybierz pozycję Parametry , aby otworzyć okienko Parametry , a następnie wybierz pozycję + Nowy parametr.
- Wprowadź następujące informacje:
- Etykieta: stan
- Typ parametru: Dowolny tekst
-
Nazwa zmiennej:
_state - Typ danych: Ciąg
- Wartość domyślna: Brak wartości domyślnej
- Wybierz pozycję Gotowe , aby utworzyć parametr.
Używanie bezpłatnego parametru tekstowego
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żna utworzyć parametr, który wybiera co najmniej jedno z dostępnych źródeł danych. Użyj tego parametru w kafelkach i innych parametrach.
Tworzenie parametru źródła danych
Wybierz pozycję Parametry , aby otworzyć okienko Parametry , a następnie wybierz pozycję + Nowy parametr.
Wprowadź następujące informacje:
- Etykieta: Źródło
- Typ parametru: Źródło danych
- Pokaż na stronach: Wybierz wszystko
- Wartości: Zaznacz wszystko
- Wartość domyślna: StormEvents
Wybierz pozycję Gotowe.
Lista parametrów w górnej części pulpitu nawigacyjnego zawiera teraz nowy parametr.
Używanie parametru źródła danych
Przejdź do zapytania dla nowego lub istniejącego kafelka.
W polu Źródło wybierz nazwę nowego parametru w obszarze Parametry źródła danych, takie jak nowy parametr źródłowy .
Wybierz pozycję Zastosuj zmiany.
Użyj parametru Source , aby zmienić źródło danych dla tego połączonego zapytania.
Użyj wyszukiwania filtrów dla filtrów z pojedynczym wyborem i filtrami wielokrotnego wyboru
W filtrach wyboru jednokrotnego i wielokrotnego wyboru wpisz żądaną wartość. Filtr aktualizuje, aby pokazywać tylko wartości zgodne z terminem wyszukiwania.