Partager via

opérateur extend

  • Article

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

Syntaxe

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

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise 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 de l’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 de l’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 de l’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 ceux qui n’existent pas dans l’entrée sont ajoutés en tant que nouvelles valeurs calculées.

Remarque

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 affiche uniquement les 10 premiers résultats. Pour voir la sortie complète, exécutez la requête.

EndTime StartTime Durée
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