Partage via

Instructions d’expression tabulaire

  • Article

L’instruction d’expression tabulaire est ce que les gens ont généralement à l’esprit lorsqu’ils parlent de requêtes. Cette instruction apparaît généralement en dernier dans la liste des instructions, et son entrée et sa sortie se composent de tables ou de jeux de données tabulaires. Deux instructions doivent être séparées par un point-virgule.

Une instruction d’expression tabulaire est généralement composée de sources de données tabulaires telles que des tables, des opérateurs de données tabulaires tels que des filtres et des projections et des opérateurs de rendu facultatifs. La composition est représentée par le caractère de canal (|), donnant à l’instruction une forme régulière qui représente visuellement le flux de données tabulaires de gauche à droite. Chaque opérateur accepte un jeu de données tabulaire « à partir du canal » et d’autres entrées, y compris des jeux de données tabulaires supplémentaires du corps de l’opérateur, puis émet un jeu de données tabulaire à l’opérateur suivant.

Syntaxe

Source | Operator1 | Operator2 | RenderInstruction

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
Source string ✔️ Source de données tabulaire. Consultez les sources de données tabulaires.
Opérateur string ✔️ Opérateurs de données tabulaires, tels que les filtres et les projections.
RenderInstruction string Opérateurs de rendu ou instructions.

Sources de données tabulaires

Une source de données tabulaire produit des jeux d’enregistrements, pour être traitée par des opérateurs de données tabulaires. La liste suivante montre les sources de données tabulaires prises en charge :

  • Références de table
  • Opérateur de plage tabulaire
  • Opérateur d’impression
  • Appel d’une fonction qui retourne une table
  • Littéral de table (« datatable »)

Exemples

Filtrer les lignes par condition

La requête suivante compte le nombre d’enregistrements dans la StormEvents table qui ont la valeur « FLORIDE » dans la State colonne.

Exécuter la requête

StormEvents 
| where State == "FLORIDA"
| count

Sortie

Count
1042

Combiner des données de deux tables

Dans l’exemple suivant, l’opérateur de jointure est utilisé pour combiner des enregistrements à partir de deux sources de données tabulaires : la StormEvents table et la PopulationData table.

Exécuter la requête

StormEvents 
| where InjuriesDirect + InjuriesIndirect > 50
| join (PopulationData) on State
| project State, Population, TotalInjuries = InjuriesDirect + InjuriesIndirect

Sortie

State Remplissage TotalInjuries
ALABAMA 4918690 60
CALIFORNIE 39562900 61
KANSAS 2915270 63
MISSOURI 6153230 422
OKLAHOMA 3973710 200
TENNESSEE 6886720 187
TEXAS 29363100 137