Instructions d’expression tabulaire

  • Article

L’instruction d’expression tabulaire est ce que les gens ont généralement à l’esprit quand ils parlent de requêtes. Cette instruction apparaît généralement en dernier dans la liste d’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, d’opérateurs de données tabulaires tels que des filtres et des projections, et d’opérateurs de rendu facultatifs. La composition est représentée par le caractère de canal (|), ce qui donne à 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 d’autres jeux de données tabulaires du corps de l’opérateur, puis émet un jeu de données tabulaire vers l’opérateur suivant qui suit.

Syntax

Source|Opérateur1|Opérateur2|RenderInstruction

Découvrez les conventions de syntaxe.

Paramètres

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

Sources de données tabulaires

Une source de données tabulaire produit des jeux d’enregistrements, qui doivent être traités par des opérateurs de données tabulaires. La liste suivante présente les sources de données tabulaires prises en charge :

Exemples

Filtrer les lignes par condition

La requête suivante compte le nombre d’enregistrements de la table dont la StormEvents valeur est « FLORIDA » dans la State colonne.

Exécuter la requête

StormEvents 
| where State == "FLORIDA"
| count

Sortie

Count
1042

Combiner les données de deux tables

Dans l’exemple suivant, l’opérateur de jointure est utilisé pour combiner les enregistrements 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