Оператор render

Переключайте службы с помощью раскрывающегося списка Версия. Дополнительные сведения о навигации.
Область применения: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Оператор render указывает агенту пользователя визуализировать результаты запроса. Он должен быть последним оператором в запросе и работает только с запросами, которые создают один табличный поток данных.

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

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

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

Совет

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

Примечание.

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

Синтаксис

[|renderwith( [ ...]]=

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

Параметры

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

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

визуализация Описание Иллюстрация
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.

Визуализация Описание Иллюстрация
areachart Диаграмма с областями. Первый столбец — ось x и должен быть числовым столбцом. Другие числовые столбцы представляют оси Y.
barchart Первый столбец — ось x и может быть текстом, датой и числом. Другие столбцы являются числовыми и отображаются как горизонтальные полосы.
columnchart Аналогично barchart, но с вертикальными полосами.
piechart Первый столбец — ось цвета, а второй — числовой.
scatterchart Граф точек. Первый столбец — ось x и должен быть числовым столбцом. Другие числовые столбцы представляют оси Y.
table По умолчанию — результаты отображаются в виде таблицы.
timechart Линейный график. Первый столбец — ось x и должен быть датой. Другие (числовые столбцы) представляют оси Y. Существует один строковый столбец, значения которого используются для группировки числовых столбцов и создания различных строк в диаграмме (дополнительные строковые столбцы игнорируются).
визуализация Описание Иллюстрация
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. Дополнительные сведения см. в разделе 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
  • Last updated on