extend-Operator

  • Artikel

Erstellt berechnete Spalten und fügt sie an das Resultset an.

Syntax

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

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich Beschreibung
T string ✔️ Zu erweiternde tabellarische Eingabe.
ColumnName string Name der Spalte, die hinzugefügt oder aktualisiert werden soll.
Ausdruck string ✔️ Berechnung, die über die Eingabe ausgeführt werden soll.
  • Wenn ColumnName ausgelassen wird, wird der Ausgabespaltenname von Expression automatisch generiert.
  • Wenn Expression mehrere Spalten zurückgibt, kann eine Liste mit Spaltennamen in Klammern angegeben werden. Anschließend erhalten die Ausgabespalten von Expression die angegebenen Namen. Wenn keine Liste der Spaltennamen angegeben wird, werden alle Ausgabespalten von Expression mit generierten Namen der Ausgabe hinzugefügt.

Gibt zurück

Eine Kopie des tabellarischen Eingaberesultsets, für die Folgendes gilt:

  1. Mit extend notierte Spaltennamen, die bereits in der Eingabe vorhanden sind, werden entfernt und als ihre neu berechneten Werte angefügt.
  2. Spaltennamen, die in extend der Eingabe nicht vorhanden sind, werden als neue berechnete Werte angefügt.

Hinweis

Der extend-Operator fügt dem Eingaberesultset eine neue Spalte hinzu, die nicht über einen Index verfügt. Wenn die neue Spalte genau so wie eine vorhandene Tabellenspalte festgelegt ist, die über einen Index verfügt, kann Kusto in den meisten Fällen automatisch den vorhandenen Index verwenden. In einigen komplexen Szenarien erfolgt diese Weitergabe jedoch nicht. Wenn das Ziel darin besteht, eine Spalte umzubenennen, verwenden Sie in solchen Fällen stattdessen den project-rename-Operator.

Beispiel

Abfrage ausführen

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

Die folgende Tabelle zeigt nur die ersten 10 Ergebnisse. Führen Sie die Abfrage aus, um die vollständige Ausgabe anzuzeigen.

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
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

Verwandte Inhalte

  • Verwenden von series_stats zum Zurückgeben mehrerer Spalten