Оператор extend

  • Статья

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

Синтаксис

T| extend [ColumnName | (ColumnName[, ...])=] Выражение [, ...]

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

Параметры

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

Возвращаемое значение

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

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

Примечание

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

Пример

Выполнить запрос

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

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

EndTime StartTime 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
01.01.2007T02:24:00Z 01.01.2007T02:24:00Z 00:00:00
01.01.2007T03:45:00Z 01.01.2007T03:45:00Z 00:00:00
2007-01-01T04:35:00Z 2007-01-01T04:35:00Z 00:00:00
01.01.2007T04:37:00Z 01.01.2007T03:37:00Z 01:00:00
01.01.2007T05:00:00Z 2007-01-01T00:00:00Z 05:00:00
01.01.2007T05:00:00Z 2007-01-01T00:00:00Z 05:00:00
01.01.2007T06:00:00Z 2007-01-01T00:00:00Z 06:00:00
01.01.2007T06:00:00Z 2007-01-01T00:00:00Z 06:00:00

См. также

  • Использование series_stats для возврата нескольких столбцов