opérateur project

  • Article

Sélectionnez les colonnes à inclure, renommer ou supprimer, puis insérez les nouvelles colonnes calculées.

L’ordre des colonnes dans le résultat est déterminé par l’ordre des arguments. Seules les colonnes spécifiées dans les arguments sont incluses dans le résultat. Toutes les autres colonnes de l’entrée sont supprimées.

Syntax

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

ou

T| projectColumnName [=Expression] [, ...]

Découvrez les conventions de syntaxe.

Paramètres

Nom Type Obligatoire Description
T string ✔️ Entrée tabulaire pour laquelle projeter certaines colonnes.
ColumnName string Nom de colonne ou liste de noms de colonnes séparés par des virgules à afficher dans la sortie.
Expression string Expression scalaire à effectuer sur l’entrée.
  • ColumnName ou Expression doit être spécifié.
  • S’il n’y a pas d’expression, une colonne columnName doit apparaître dans 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. 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.

Notes

Il n’est pas recommandé de retourner une nouvelle colonne calculée portant le même nom qu’une colonne existante dans l’entrée.

Retours

Table avec des colonnes nommées en tant qu’arguments. Contient le même nombre de lignes que la table d’entrée.

Exemples

Afficher uniquement des colonnes spécifiques

Affiche uniquement le EventId, Statede EventType la StormEvents table.

Exécuter la requête

StormEvents
| project EventId, State, EventType

Le tableau de résultats suivant montre uniquement les 10 premiers résultats.

EventId État Type d’événement
61032 ATLANTIQUE SUD Trombe marine
60904 FLORIDE Fortes précipitations
60913 FLORIDE Tornade
64588 GEORGIE Vent d’orage
68796 MISSISSIPPI Vent d’orage
68814 MISSISSIPPI Tornade
68834 MISSISSIPPI Vent d’orage
68846 MISSISSIPPI Grêle
73241 SAMOA AMÉRICAINES Crue soudaine
64725 KENTUCKY Crue
... ... ...

Manipulations potentielles à l’aide d’un projet

La requête suivante renomme la BeginLocation colonne et crée une colonne appelée TotalInjuries à partir d’un calcul sur deux colonnes existantes.

Exécuter la requête

StormEvents
| project StartLocation = BeginLocation, TotalInjuries = InjuriesDirect + InjuriesIndirect
| where TotalInjuries > 5

Le tableau suivant montre uniquement les 10 premiers résultats.

StartLocation TotalInjuries
LYDIA 15
ROYAL 15
GÖTEBORG 9
PLAINES 8
KNOXVILLE 9
CAROL STREAM 11
HOLLY 9
RUFFIN 9
ENTERPRISE MUNI ARPT 50
COLLIERVILLE 6
... ...

Contenu connexe