Поделиться через

Оператор render

  • Статья

Область применения: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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

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

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

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

Совет

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

Примечание.

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

Синтаксис

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

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

Параметры

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

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

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

Примечание.

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

Визуализация Description Иллюстрация
areachart Диаграмма с областями. Первый столбец (должен быть числовым столбцом) — это ось X. Другие числовые столбцы представляют оси Y.
barchart Первый столбец — это ось X. Может включать текст, дату и время или числа. Другие столбцы являются числовыми и отображаются в виде горизонтальных полос.
columnchart Аналогично barchart, но с вертикальными полосами.
piechart Первый столбец — ось цвета, второй столбец — числовой.
scatterchart Граф точек. Первый столбец (должен быть числовым столбцом) — это ось X. Другие числовые столбцы представляют оси Y.
table По умолчанию — результаты отображаются в виде таблицы.
timechart Линейный график. Первый столбец — ось x и должен быть датой. Другие (числовые столбцы) представляют оси Y. Существует один строковый столбец, значения которого используются для группировки числовых столбцов и создания различных строк в диаграмме (дополнительные строковые столбцы игнорируются).
визуализация Description Иллюстрация
anomalychart Аналогично тайм-диаграмме, но выделяет аномалии с помощью функции series_decompose_anomalies .
areachart Диаграмма с областями.
barchart отображается как горизонтальные полосы.
card Первая запись результата обрабатывается как набор скалярных значений и отображается как карточка.
columnchart Аналогично barchart, но с вертикальными полосами.
linechart Линейный график.
piechart Первый столбец — ось цвета, второй столбец — числовой.
scatterchart Граф точек.
stackedareachart Граф с областями с накоплением.
table По умолчанию — результаты отображаются в виде таблицы.
timechart Линейный график. Первый столбец — ось x и должен быть датой и временем. Другие (числовые столбцы) представляют оси 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 Description
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 Description
none Для всех данных ряда отображается отдельная ось Y. (по умолчанию)
axes Отображается одна диаграмма с несколькими осями Y (по одной на ряд).
panels Отображается одна диаграмма для каждого значения ycolumn (до некоторого предела).

Как отрисовка непрерывных данных

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

  • Один столбец в таблице представляет ось 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