Istruzioni di espressione tabulare

Articolo
01/23/2024

L'istruzione dell'espressione tabulare è ciò che gli utenti hanno in genere in mente quando parlano di query. Questa istruzione viene in genere visualizzata per ultima nell'elenco di istruzioni e sia il relativo input che il relativo output sono costituiti da tabelle o set di dati tabulari. Le due istruzioni devono essere separate da un punto e virgola.

Un'istruzione di espressione tabulare è in genere costituita da origini dati tabulari , ad esempio tabelle, operatori di dati tabulari come filtri e proiezioni e operatori di rendering facoltativi. La composizione è rappresentata dal carattere pipe (|), fornendo all'istruzione una forma regolare che rappresenta visivamente il flusso di dati tabulari da sinistra a destra. Ogni operatore accetta un set di dati tabulare "dalla pipe" e altri input, inclusi più set di dati tabulari dal corpo dell'operatore, quindi genera un set di dati tabulare all'operatore successivo che segue.

Sintassi

Fonte|Operatore1|Operatore2|RenderInstruction

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Tipo	Obbligatoria	Descrizione
Origine	`string`	✔️	Origine dati tabulare. Vedere Origini dati tabulari.
Operatore	`string`	✔️	Operatori di dati tabulari, ad esempio filtri e proiezioni.
RenderInstruction	`string`		Operatori di rendering o istruzioni.

Origini dati tabulari

Un'origine dati tabulare produce set di record da elaborare ulteriormente dagli operatori di dati tabulari. L'elenco seguente mostra le origini dati tabulari supportate:

Riferimenti a tabelle
Operatore intervallo tabulare
Operatore di stampa
Chiamata di una funzione che restituisce una tabella
Valore letterale tabella ("datatable")

Esempio

Filtrare le righe in base alla condizione

La query seguente conta il numero di record nella StormEvents tabella con valore "FLORIDA" nella State colonna .

Eseguire la query

StormEvents 
| where State == "FLORIDA"
| count

Output

Conteggio
1042

Combinare dati da due tabelle

Nell'esempio seguente viene usato l'operatore join per combinare i record di due origini dati tabulari: la StormEvents tabella e la PopulationData tabella.