Udostępnij za pośrednictwem


operator extend

Dotyczy: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Tworzy kolumny obliczeniowe i dołącza je do zestawu wyników.

Składnia

T [ColumnName ColumnName( | [, ...] ] =)| extendWyrażenie [, ...]

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
T string ✔️ Dane wejściowe tabelaryczne do rozszerzenia.
Nazwakolumny string Nazwa kolumny do dodania lub zaktualizowania.
Expression string ✔️ Obliczanie wykonywane na danych wejściowych.
  • Jeśli parametr ColumnName zostanie pominięty, nazwa kolumny wyjściowej wyrażenia jest generowana automatycznie.
  • Jeśli wyrażenie zwraca więcej niż jedną kolumnę, w nawiasach można określić listę nazw kolumn. Następnie kolumny wyjściowe wyrażenia otrzymują określone nazwy. Jeśli nie określono listy nazw kolumn, do danych wyjściowych zostaną dodane wszystkie kolumny wyjściowe wyrażenia z wygenerowanymi nazwami.

Zwraca

Kopia wejściowego zestawu wyników tabelarycznych, taka jak:

  1. Nazwy kolumn, extend które już istnieją w danych wejściowych, są usuwane i dołączane jako ich nowe wartości obliczeniowe.
  2. Nazwy kolumn, extend które nie istnieją w danych wejściowych, są dołączane jako nowe wartości obliczeniowe.

Uwaga

Operator extend dodaje nową kolumnę do wejściowego zestawu wyników, który nie ma indeksu. W większości przypadków, jeśli nowa kolumna jest ustawiona na dokładnie taką samą jak istniejąca kolumna tabeli z indeksem, usługa Kusto może automatycznie używać istniejącego indeksu. Jednak w niektórych złożonych scenariuszach propagacja nie jest wykonywana. W takich przypadkach, jeśli celem jest zmiana nazwy kolumny, użyj project-rename operatora zamiast tego.

Przykład

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

W poniższej tabeli przedstawiono tylko pierwsze 10 wyników. Aby wyświetlić pełne dane wyjściowe, uruchom zapytanie.

EndTime StartTime Czas trwania
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