Partager via


opérateur extend

S’applique à : ✅Microsoft Fabric

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 Catégorie Requise Descriptif
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

Retourne une copie du jeu de résultats tabulaire d’entrée, de sorte que :

  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.

Exemples

L’exemple suivant montre comment utiliser l’opérateur extend pour créer une colonne appelée Duration qui calcule la différence entre les colonnes et EndTime les StartTime colonnes de la StormEvents table.

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.

Heure de fin Heure de début 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