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


Оператор extend

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

Создает вычисляемые столбцы и добавляет их в результирующий набор.

Синтаксис

T | extend [ColumnName | (ColumnName[, ...]) =] Expression [, ...]

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

Параметры

Имя (название) Type Обязательно Описание
T string ✔️ Табличные входные данные для расширения.
ColumnName string Имя столбца для добавления или обновления.
Выражение string ✔️ Вычисление для выполнения входных данных.
  • Если имя столбца опущено, имя выходного столбца выражения создается автоматически.
  • Если Expression возвращает более одного столбца, список имен столбцов можно указать в скобках. Затем выходные столбцы выражения задаются указанными именами. Если список имен столбцов не указан, все выходные столбцы выражения с созданными именами добавляются в выходные данные.

Возвраты

Копия табличного результирующего набора входных данных:

  1. Имена столбцов, записанные extend, которые уже существуют во входных данных, удаляются и добавляются в качестве их новых вычисляемых значений.
  2. Имена столбцов, extend которые не существуют в входных данных, добавляются в качестве новых вычисляемых значений.

Примечание.

Оператор extend добавляет новый столбец в результирующий набор выходных данных, который не имеет индекса. В большинстве случаев, если новый столбец настроен точно так же, как и существующий столбец таблицы с индексом, Kusto может автоматически использовать существующий индекс. Однако в некоторых сложных сценариях это распространение не выполняется. В таких случаях, если целью является переименование столбца, следует использовать оператор project-rename .

Пример

StormEvents
| project EndTime, StartTime
| extend Duration = EndTime - StartTime

В следующей таблице показаны только первые 10 результатов. Чтобы просмотреть полные выходные данные, выполните запрос.

EndTime Время начала Duration
2007-01-01T00:00:00Z 2007-01-01T00:00:00Z 00:00:00
2007-01-01T00:25:00Z 2007-01-01T00:25:00Z 00:00:00
2007-01-01T02:24:00Z 2007-01-01T02:24:00Z 00:00:00
2007-01-01T03:45:00Z 2007-01-01T03:45:00Z 00:00:00
2007-01-01T04:35:00Z 2007-01-01T04:35:00Z 00:00:00
2007-01-01T04:37:00Z 2007-01-01T03:37:00Z 01:00:00
2007-01-01T05:00:00Z 2007-01-01T00:00:00Z 05:00:00
2007-01-01T05:00:00Z 2007-01-01T00:00:00Z 05:00:00
2007-01-01T06:00:00Z 2007-01-01T00:00:00Z 06:00:00
2007-01-01T06:00:00Z 2007-01-01T00:00:00Z 06:00:00
  • Использование series_stats для возврата нескольких столбцов