Partager via

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.

Syntaxe

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

or

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

En savoir plus sur les conventions de syntaxe.

Paramètres

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

Remarque

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

Affichez uniquement le EventId, EventType Statedu StormEvents tableau.

Exécuter la requête

StormEvents
| project EventId, State, EventType

Le tableau de résultats suivant affiche 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 affiche uniquement les 10 premiers résultats.

StartLocation TotalInjuries
LYDIE 15
ROYAL 15
GÖTEBORG 9
PLAINE 8
KNOXVILLE 9
CAROL STREAM 11
HOUX 9
RUFFIN 9
ENTERPRISE MUNI ARPT 50
COLLIERVILLE 6
... ...

Contenu connexe