operator renderowania

  • Artykuł

Instruuje agenta użytkownika, aby renderował wizualizację wyników zapytania.

Operator renderowania musi być ostatnim operatorem w zapytaniu i może być używany tylko z zapytaniami, które generują pojedynczy wynik strumienia danych tabelarycznych. Operator renderowania nie modyfikuje danych. Wprowadza adnotację ("Wizualizacja") do właściwości rozszerzonych wyniku. Adnotacja zawiera informacje podane przez operatora w zapytaniu. Interpretacja informacji o wizualizacji jest wykonywana przez agenta użytkownika. Różni agenci, tacy jak Kusto.Explorer lub Internetowy interfejs użytkownika usługi Azure Data Explorer, mogą obsługiwać różne wizualizacje.

Model danych operatora renderowania analizuje dane tabelaryczne tak, jakby miał trzy rodzaje kolumn:

  • Kolumna osi x (wskazywana xcolumn przez właściwość).
  • Kolumny serii (dowolna liczba kolumn wskazywanych przez series właściwość). Dla każdego rekordu połączone wartości tych kolumn definiują pojedynczą serię, a wykres ma tyle serii, ile jest różnych połączonych wartości.
  • Kolumny osi y (dowolna ycolumns liczba kolumn wskazywanych przez właściwość). Dla każdego rekordu seria ma dowolną liczbę miar ("punktów" na wykresie), ponieważ istnieją kolumny osi y.

Porada

  • Użyj polecenia wherei topsummarize , aby ograniczyć wyświetlany wolumin.
  • Posortuj dane, aby zdefiniować kolejność osi x.
  • Agenci użytkownika mogą "odgadnąć" wartość właściwości, które nie są określone przez zapytanie. W szczególności posiadanie "nieinterestujących" kolumn w schemacie wyniku może przekładać się na ich błędne zgadywanie. Jeśli tak się stanie, spróbuj wykonać projekcję takich kolumn.

Uwaga

Istnieją pewne wizualizacje, które są dostępne tylko w pulpitach nawigacyjnych usługi Azure Data Explorer. Aby uzyskać więcej informacji, zobacz Wizualizacje specyficzne dla pulpitu nawigacyjnego.

Składnia

T|rendervisualization [with(propertyName=propertyValue [, ...])]

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
T string ✔️ Nazwa tabeli wejściowej.
Wizualizacji string ✔️ Wskazuje rodzaj wizualizacji do użycia. Musi być jedną z obsługiwanych wartości na poniższej liście.
propertyName, propertyValue string Rozdzielona przecinkami lista par właściwości klucz-wartość. Zobacz obsługiwane właściwości.

Wizualizacja

Wizualizacji Opis Ilustracji
anomalychart Podobnie jak w przypadku wykresu czasowego, ale wyróżnia anomalie przy użyciu funkcji series_decompose_anomalies .
areachart Wykres warstwowy.
barchart wyświetlane jako paski poziome.
card Pierwszy rekord wyniku jest traktowany jako zestaw wartości skalarnych i wyświetlany jako karta.
columnchart Podobnie jak barchart w przypadku pionowych pasków zamiast poziomych pasków.
ladderchart Dwie ostatnie kolumny są osią x, a inne kolumny to oś y.
linechart Wykres liniowy.
piechart Pierwsza kolumna to oś kolorów, druga kolumna jest numeryczna.
pivotchart Wyświetla tabelę przestawną i wykres. Użytkownik może interaktywnie wybierać dane, kolumny, wiersze i różne typy wykresów.
scatterchart Wykres punktów.
stackedareachart Skumulowany wykres warstwowy.
table Ustawienie domyślne — wyniki są wyświetlane jako tabela.
timechart Wykres liniowy. Pierwsza kolumna to oś x i musi być datą/godziną. Inne (liczbowe) kolumny to osie y.
timepivot Interaktywna nawigacja po wierszach czasu zdarzeń (przestawianie na osi czasu)
treemap Wyświetla dane hierarchiczne jako zestaw zagnieżdżonych prostokątów.

Uwaga

Wizualizacje wykresu drabiny, wykresu przestawnego, elementu przestawnego i mapy drzewa mogą być używane w programie Kusto.Explorer, ale nie są dostępne w internetowym interfejsie użytkownika usługi Azure Data Explorer.

Wizualizacja Opis Ilustracji
areachart Wykres warstwowy. Pierwsza kolumna to oś x i powinna być kolumną liczbową. Inne kolumny liczbowe to osie y.
barchart Pierwsza kolumna jest osią x i może być tekstem, datą/godziną lub liczbą. Inne kolumny są numeryczne, wyświetlane jako paski poziome.
columnchart Podobnie jak barchart w przypadku pionowych pasków zamiast poziomych pasków.
piechart Pierwsza kolumna to oś kolorów, druga kolumna jest numeryczna.
scatterchart Wykres punktów. Pierwsza kolumna to oś x i powinna być kolumną liczbową. Inne kolumny liczbowe to osie y.
table Ustawienie domyślne — wyniki są wyświetlane jako tabela.
timechart Wykres liniowy. Pierwsza kolumna to oś x i powinna być datą/godziną. Inne (liczbowe) kolumny to osie y. Istnieje jedna kolumna ciągu, której wartości są używane do "grupowania" kolumn liczbowych i tworzenia różnych linii na wykresie (kolejne kolumny ciągów są ignorowane).
Wizualizacji Opis Ilustracji
anomalychart Podobnie jak w przypadku wykresu czasowego, ale wyróżnia anomalie przy użyciu funkcji series_decompose_anomalies .
areachart Wykres warstwowy.
barchart wyświetlane jako paski poziome.
card Pierwszy rekord wyniku jest traktowany jako zestaw wartości skalarnych i wyświetlany jako karta.
columnchart Podobnie jak barchart w przypadku pionowych pasków zamiast poziomych pasków.
linechart Wykres liniowy.
piechart Pierwsza kolumna to oś kolorów, druga kolumna jest numeryczna.
scatterchart Wykres punktów.
stackedareachart Skumulowany wykres warstwowy.
table Ustawienie domyślne — wyniki są wyświetlane jako tabela.
timechart Wykres liniowy. Pierwsza kolumna to oś x i musi być datą/godziną. Inne (liczbowe) kolumny to osie y.

Obsługiwane właściwości

Propertyname/WłaściwośćValue wskazuje dodatkowe informacje do użycia podczas renderowania. Wszystkie właściwości są opcjonalne. Obsługiwane właściwości to:

PropertyName Propertyvalue
accumulate Czy wartość każdej miary jest dodawana do wszystkich swoich poprzedników. (true lub false)
kind Dalsze opracowanie rodzaju wizualizacji. Aby uzyskać więcej informacji, zobacz kind właściwość.
legend Czy wyświetlać legendę, czy nie (visible lub hidden).
series Rozdzielana przecinkami lista kolumn, których połączone wartości dla rekordu definiują serię, do której należy rekord.
ymin Minimalna wartość, która ma być wyświetlana na osi Y.
ymax Maksymalna wartość, która ma być wyświetlana na osi Y.
title Tytuł wizualizacji (typu string).
xaxis Jak skalować oś x (linear lub log).
xcolumn Która kolumna w wyniku jest używana dla osi x.
xtitle Tytuł osi x (typu string).
yaxis Jak skalować oś y (linear lub log).
ycolumns Rozdzielana przecinkami lista kolumn, które składają się z wartości podanych na wartość kolumny x.
ysplit Jak podzielić wiele wizualizacji. Aby uzyskać więcej informacji, zobacz y-split właściwość.
ytitle Tytuł osi y (typu string).
anomalycolumns Właściwość jest odpowiednia tylko dla anomalychartelementu . Rozdzielana przecinkami lista kolumn, które będą traktowane jako seria anomalii i wyświetlane jako punkty na wykresie
PropertyName Propertyvalue
kind Dalsze opracowanie rodzaju wizualizacji. Aby uzyskać więcej informacji, zobacz kind właściwość.
series Rozdzielana przecinkami lista kolumn, których połączone wartości dla rekordu definiują serię, do której należy rekord.
title Tytuł wizualizacji (typu string).

kind Właściwość

Tę wizualizację można jeszcze bardziej rozwinąć, udostępniając kind właściwość. Obsługiwane wartości tej właściwości to:

Wizualizacja kind Opis
areachart default Każdy "obszar" stoi na własną rękę.
unstacked Tak samo jak default.
stacked Stos "obszary" po prawej stronie.
stacked100 Stos "obszary" po prawej stronie i rozciągnąć każdy z nich do tej samej szerokości co pozostałe.
barchart default Każdy "bar" stoi na własną rękę.
unstacked Tak samo jak default.
stacked Stos "bary".
stacked100 Stos "słupki" i rozciągnij każdy z nich do tej samej szerokości co pozostałe.
columnchart default Każda "kolumna" jest sama w sobie.
unstacked Tak samo jak default.
stacked Stos "kolumny" jeden na drugim.
stacked100 Stos "kolumny" i rozciągnij każdy z nich do tej samej wysokości co pozostałe.
scatterchart map Oczekiwane kolumny to [Długość geograficzna, Szerokość geograficzna] lub Punkt GeoJSON. Kolumna serii jest opcjonalna. Aby uzyskać więcej informacji, zobacz Wizualizacje geoprzestrzenne.
piechart map Oczekiwane kolumny to [Długość geograficzna, Szerokość geograficzna] lub Punkt GeoJSON, oś kolorów i liczba. Obsługiwane w programie Kusto Explorer desktop. Aby uzyskać więcej informacji, zobacz Wizualizacje geoprzestrzenne.

ysplit Właściwość

Niektóre wizualizacje obsługują dzielenie na wiele wartości osi y:

ysplit Opis
none Dla wszystkich danych serii jest wyświetlana pojedyncza oś y. (Domyślnie)
axes Pojedynczy wykres jest wyświetlany z wieloma osiami y (jeden na serię).
panels Jeden wykres jest renderowany dla każdej ycolumn wartości (do pewnego limitu).

Jak renderować dane ciągłe

Kilka wizualizacji jest używanych do renderowania sekwencji wartości, linechartna przykład , i timechartareachart. Te wizualizacje mają następujący model koncepcyjny:

  • Jedna kolumna w tabeli reprezentuje oś x danych. Tę kolumnę xcolumn można jawnie zdefiniować przy użyciu właściwości . Jeśli nie zdefiniowano, agent użytkownika wybiera pierwszą kolumnę odpowiednią dla wizualizacji.
    • Na przykład: w wizualizacji timechart agent użytkownika używa pierwszej datetime kolumny.
    • Jeśli ta kolumna jest typu dynamic i zawiera tablicę, poszczególne wartości w tablicy będą traktowane jako wartości osi x.
  • Co najmniej jedna kolumna w tabeli reprezentuje jedną lub więcej miar, które różnią się w zależności od osi x. Te kolumny można jawnie zdefiniować przy użyciu ycolumns właściwości . Jeśli nie zdefiniowano, agent użytkownika wybiera wszystkie kolumny odpowiednie dla wizualizacji.
    • Na przykład: w timechart wizualizacji agent użytkownika używa wszystkich kolumn z wartością liczbową, która nie została określona w inny sposób.
    • Jeśli oś x jest tablicą, wartości każdej osi y powinny być również tablicą o podobnej długości, a każda oś y występuje w jednej kolumnie.
  • Zero lub więcej kolumn w tabeli reprezentuje unikatowy zestaw wymiarów, które grupują miary. Te kolumny można określić za pomocą series właściwości lub agent użytkownika automatycznie wybierze je z kolumn, które w przeciwnym razie nie są określone.

Zawartość pokrewna

Uwaga

Model danych operatora renderowania analizuje dane tabelaryczne tak, jakby zawierał trzy rodzaje kolumn:

  • Kolumna osi x (wskazywana xcolumn przez właściwość).
  • Kolumny serii (dowolna liczba kolumn wskazywanych przez series właściwość).
  • Kolumny osi y (dowolna liczba kolumn wskazywanych przez ycolumns właściwość). Dla każdego rekordu seria ma tyle miar ("punktów" na wykresie), jak istnieją kolumny osi y.

Przykład

InsightsMetrics
| where Computer == "DC00.NA.contosohotels.com"
| where Namespace  == "Processor" and Name == "UtilizationPercentage"
| summarize avg(Val) by Computer, bin(TimeGenerated, 1h)
| render timechart