Оператор render

  • Статья

Указывает агенту пользователя отобразить визуализацию результатов запроса.

Оператор render должен быть последним оператором в запросе и может использоваться только с запросами, которые создают один результат потока табличных данных. Оператор render не изменяет данные. Он вставляет заметку (Visualization) в расширенные свойства результата. Такая заметка содержит сведения, предоставленные оператором в запросе. Интерпретация данных визуализации выполняется агентом пользователя. Различные агенты, например Kusto. Обозреватель или веб-интерфейс Azure Data Explorer могут поддерживать различные визуализации.

Модель данных оператора render воспринимает табличные данные так, как если бы они включали столбцы трех типов:

  • Столбец оси X (указывается свойством xcolumn).
  • Столбцы ряда (любое количество столбцов, указанных свойством series ). Для каждой записи объединенные значения этих столбцов определяют один ряд, и диаграмма имеет столько рядов, сколько существует различных объединенных значений.
  • Столбцы оси Y (любое число столбцов, определяемое свойством ycolumns). Для каждой записи ряд содержит столько измерений (точки на диаграмме), сколько есть столбцов на оси Y.

Совет

  • Чтобы ограничить объем отображаемых данных, используйте where, summarize и top.
  • Отсортируйте данные, чтобы определить порядок отображения на оси X.
  • Агенты пользователя могут самостоятельно задавать значения свойств, не указанных в запросе. В частности, наличие "неинтересных" столбцов в схеме результата может привести к неправильному подбору значений. В таких случаях старайтесь удалять такие столбцы.

Примечание

Некоторые визуализации доступны только на панелях мониторинга Azure Data Explorer. Дополнительные сведения см. в разделе Визуальные элементы, относящиеся к панели мониторинга.

Синтаксис

T|renderвизуализация [with(propertyName=propertyValue [, ...])]

Дополнительные сведения о соглашениях о синтаксисе.

Параметры

Имя Тип Обязательно Описание
T string ✔️ Имя входной таблицы.
Визуализации string ✔️ Указывает тип визуализации для использования. Должно быть одним из поддерживаемых значений в следующем списке.
propertyName, propertyValue string Разделенный запятыми список пар свойств "ключ-значение". См. раздел Поддерживаемые свойства.

Визуализация

Визуализации Описание Иллюстрация
anomalychart Эквивалентно timechart, но выделяет аномалии с помощью функции series_decompose_anomalies.
areachart Диаграмма с областями.
barchart отображается в виде горизонтальных полос.
card Первая запись результата обрабатывается как набор скалярных значений и отображается как карточка.
columnchart Аналогично barchart, но с вертикальными полосами.
ladderchart Последние два столбца — это ось X, другие столбцы представляют оси Y.
linechart линейный график.
piechart первый столбец — это ось цвета, второй столбец имеет тип numeric.
pivotchart Отображает сводную таблицу и диаграмму. Пользователь может интерактивно выбирать данные, столбцы, строки и разные типы диаграмм.
scatterchart Граф точек.
stackedareachart Граф с областями с накоплением.
table По умолчанию — результаты отображаются в виде таблицы.
timechart линейный график. Первый столбец является осью X и должен иметь значение datetime. Другие (числовые столбцы) представляют оси Y.
timepivot Интерактивная навигация по временной шкале событий (сведения об оси времени).
treemap Отображает иерархические данные в виде набора вложенных прямоугольников.

Примечание

В Kusto можно использовать визуализации диаграммы лестницы, сводной диаграммы, диаграммы времени и диаграммы дерева. Обозреватель, но недоступны в пользовательском веб-интерфейсе Azure Data Explorer.

Визуализация Описание Иллюстрация
areachart Диаграмма с областями. Первый столбец (должен быть числовым столбцом) — это ось X. Другие числовые столбцы представляют оси Y.
barchart Первый столбец — это ось X. Может включать текст, дату и время или числа. Другие столбцы являются числовыми и отображаются в виде горизонтальных полос.
columnchart Аналогично barchart, но с вертикальными полосами.
piechart первый столбец — это ось цвета, второй столбец имеет тип numeric.
scatterchart Граф точек. Первый столбец (должен быть числовым столбцом) — это ось X. Другие числовые столбцы представляют оси Y.
table По умолчанию — результаты отображаются в виде таблицы.
timechart линейный график. Первый столбец — это ось X с типом данных datetime. Другие (числовые столбцы) представляют оси Y. Существует один строковый столбец, значения которого используются для группировки числовых столбцов и создания разных линий на диаграмме (дополнительные строковые столбцы игнорируются).
Визуализации Описание Иллюстрация
anomalychart Эквивалентно timechart, но выделяет аномалии с помощью функции series_decompose_anomalies.
areachart Диаграмма с областями.
barchart отображается в виде горизонтальных полос.
card Первая запись результата обрабатывается как набор скалярных значений и отображается как карточка.
columnchart Аналогично barchart, но с вертикальными полосами.
linechart линейный график.
piechart первый столбец — это ось цвета, второй столбец имеет тип numeric.
scatterchart Граф точек.
stackedareachart Граф с областями с накоплением.
table По умолчанию — результаты отображаются в виде таблицы.
timechart линейный график. Первый столбец является осью X и должен иметь значение datetime. Другие (числовые столбцы) представляют оси Y.

Поддерживаемые свойства

PropertyName/PropertyValue включают дополнительные сведения, которые используются при рендеринге. Все свойства являются необязательными. Поддерживаются следующие свойства:

PropertyName PropertyValue
accumulate Указывает, добавляется ли значение каждой меры ко всем предшествующим (true или false).
kind Уточняет тип визуализации. Дополнительные сведения см. в разделеkind свойство .
legend Указывает, следует ли отображать условные обозначения (visible или hidden).
series Разделенный запятыми список столбцов — его объединенные значения отдельных записей определяют ряд, к которому принадлежит запись.
ymin Минимальное значение, отображаемое на оси Y.
ymax Максимальное значение, отображаемое на оси Y.
title Заголовок визуализации (типа string).
xaxis Способ масштабирования оси X (linear или log).
xcolumn Какой столбец в результате используется для оси X.
xtitle Заголовок оси X (типа string).
yaxis Способ масштабирования оси Y (linear или log).
ycolumns Разделенный запятыми список столбцов, состоящий из значений, заданных для каждого значения столбца X.
ysplit Способ разделения визуализации на несколько визуализаций. Дополнительные сведения см. в разделеy-split свойство .
ytitle Заголовок оси Y (типа string).
anomalycolumns Свойство применимо только к anomalychart. Разделенный запятыми список столбцов, который будет рассматриваться как ряд аномалий и отображаться в виде точек на диаграмме
PropertyName PropertyValue
kind Уточняет тип визуализации. Дополнительные сведения см. в разделеkind свойство .
series Разделенный запятыми список столбцов — его объединенные значения отдельных записей определяют ряд, к которому принадлежит запись.
title Заголовок визуализации (типа string).

Свойствоkind

Эту визуализацию можно дополнительно усовершенствовать, предоставив kind свойство . Поддерживаемые значения этого свойства:

Визуализация kind Описание:
areachart default Каждая область отображается отдельно.
unstacked Эквивалентно default.
stacked Группирует области справа.
stacked100 Группирует области справа и растягивает каждую до ширины других.
barchart default Каждая панель отображается отдельно.
unstacked Эквивалентно default.
stacked Группирует панели.
stacked100 Группирует панели и растягивает каждую до ширины других.
columnchart default Каждый столбец отображается отдельно.
unstacked Эквивалентно default.
stacked Группирует столбцы поверх друг друга.
stacked100 Группирует столбцы и растягивает каждый до высоты других.
scatterchart map Ожидаемые столбцы — это [Longitude, Latitude] или точка GeoJSON. Столбец ряда является необязательным. Дополнительные сведения см. в разделе Геопространственные визуализации.
piechart map Ожидаемые столбцы — это [Longitude, Latitude] или точка GeoJSON, ось цвета и числовые значения. Поддерживается в Kusto Explorer для настольных компьютеров. Дополнительные сведения см. в разделе Геопространственные визуализации.

Свойствоysplit

Некоторые визуализации поддерживают разделение на несколько значений по оси Y:

ysplit Описание:
none Для всех данных ряда отображается отдельная ось Y. (по умолчанию)
axes Отображается одна диаграмма с несколькими осями Y (по одной на ряд).
panels Отображается одна диаграмма для каждого значения ycolumn (до некоторого предела).

Отображение непрерывных данных

Для отрисовки последовательностей значений используется несколько визуализаций, например linechart, timechartи areachart. Эти визуализации имеют следующую концептуальную модель:

  • Один столбец в таблице представляет ось X данных. Этот столбец можно явно определить с помощью xcolumn свойства . Если этот параметр не определен, агент пользователя выбирает первый столбец, подходящий для визуализации.
    • Например, в визуализации timechart агент пользователя использует первый datetime столбец.
    • Если этот столбец имеет тип dynamic и содержит массив, отдельные значения в массиве будут рассматриваться как значения оси X.
  • Один или несколько столбцов в таблице представляют одну или несколько мер, которые зависят от оси X. Эти столбцы можно явно определить с помощью ycolumns свойства . Если этот параметр не определен, агент пользователя выбирает все столбцы, подходящие для визуализации.
    • Например, в визуализации timechart агент пользователя использует все столбцы с числовым значением, которое не было указано иначе.
    • Если ось X является массивом, значения каждой оси Y также должны быть массивом аналогичной длины, при этом каждая ось Y находится в одном столбце.
  • Ноль или несколько столбцов в таблице представляют уникальный набор измерений, которые группировать меры. Эти столбцы можно указать с помощью series свойства , или агент пользователя автоматически выберет их из столбцов, которые в противном случае не указаны.

См. также

Примечание

Модель данных оператора render воспринимает табличные данные так, как если бы они включали столбцы трех типов:

  • Столбец оси X (указывается свойством xcolumn).
  • Столбцы рядов (любое число столбцов, определяемое свойством series).
  • Столбцы оси Y (любое число столбцов, определяемое свойством ycolumns). Для каждой записи ряд содержит столько измерений (точки на диаграмме), сколько есть столбцов на оси Y.

Пример

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