opérateur extend

  • Article

Crée des colonnes calculées et les ajoute au jeu de résultats.

Syntax

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

Découvrez les conventions de syntaxe.

Paramètres

Nom Type Obligatoire Description
T string ✔️ Entrée tabulaire à étendre.
ColumnName string Nom de la colonne à ajouter ou à mettre à jour.
Expression string ✔️ Calcul à effectuer sur l’entrée.
  • Si ColumnName est omis, le nom de colonne de sortie Expression est généré automatiquement.
  • Si l’Expression retourne plusieurs colonnes, une liste de noms de colonnes peut être spécifiée entre parenthèses. Ensuite, les colonnes de sortie d’Expression reçoivent les noms spécifiés. Si aucune liste des noms de colonnes n’est spécifiée, toutes les colonnes de sortie d’Expression avec des noms générés sont ajoutées à la sortie.

Retours

Copie du jeu de résultats tabulaire d’entrée, par exemple :

  1. Les noms de colonnes indiqués par extend qui existent déjà dans l’entrée sont supprimés et ajoutés en tant que nouvelles valeurs calculées.
  2. Les noms de colonnes notés par extend qui n’existent pas dans l’entrée sont ajoutés en tant que nouvelles valeurs calculées.

Notes

L’opérateur extend ajoute une colonne au jeu de résultats d’entrée qui n’a pas d’index. Dans la plupart des cas, si la nouvelle colonne est définie comme étant exactement la même qu’une colonne de table existante avec un index, Kusto peut utiliser automatiquement l’index existant. Toutefois, dans certains scénarios complexes, cette propagation n’est pas effectuée. Dans ce cas, si l’objectif est de renommer une colonne, utilisez plutôt l’opérateur project-rename.

Exemple

Exécuter la requête

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

Le tableau suivant montre uniquement les 10 premiers résultats. Pour voir la sortie complète, exécutez la requête.

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

Contenu connexe