operator extend

  • Artykuł

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

Składnia

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

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
T string ✔️ Dane wejściowe tabelaryczne do rozszerzenia.
Columnname string Nazwa kolumny do dodania lub zaktualizowania.
Wyrażenie 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ę, listę nazw kolumn można określić w nawiasach. 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, w tym:

  1. Nazwy kolumn, które extend już istnieją w danych wejściowych, są usuwane i dołączane jako 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 ma być dokładnie taka sama 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, należy zamiast tego project-rename użyć operatora .

Przykład

Uruchamianie zapytania

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

Zawartość pokrewna