opérateur project
S’applique à : ✅Microsoft Fabric✅✅
Sélectionne les colonnes à inclure, renommer ou déplacer et insère de 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
Les exemples de cette section montrent comment utiliser la syntaxe pour vous aider à commencer.
Les exemples de cet article utilisent des tables disponibles publiquement dans le cluster d’aide, comme la table
StormEvents
dans la base de données Exemples.
Les exemples de cet article utilisent des tables disponibles publiquement, telles que la table
StormEvents
dans l’analyse météo exemples de données.
Afficher uniquement des colonnes spécifiques
Affichez uniquement le EventId
, State
EventType
du StormEvents
tableau.
StormEvents
| project EventId, State, EventType
de sortie
Le tableau affiche 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.
StormEvents
| project StartLocation = BeginLocation, TotalInjuries = InjuriesDirect + InjuriesIndirect
| where TotalInjuries > 5
de sortie
Le tableau affiche 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 |
... | ... |