Tabellbaserade uttrycksinstruktioner

Artikel
01/23/2024

Uttrycket tabelluttryck är vad personer vanligtvis har i åtanke när de pratar om frågor. Den här instruktionen visas vanligtvis sist i instruktionslistan, och både indata och utdata består av tabeller eller tabelldatauppsättningar. Två instruktioner måste avgränsas med ett semikolon.

En tabelluttrycksinstruktor består vanligtvis av tabelldatakällor som tabeller, tabelldataoperatorer som filter och projektioner och valfria renderingsoperatorer. Sammansättningen representeras av pipe-tecknet (|), vilket ger instruktionen ett vanligt formulär som visuellt representerar flödet av tabelldata från vänster till höger. Varje operator accepterar en tabelldatauppsättning "från röret" och andra indata, inklusive fler tabelldatauppsättningar från operatorns brödtext, och genererar sedan en tabelldatauppsättning till nästa operator som följer.

Syntax

Källkod|Operator1|Operator2|RenderInstruction

Läs mer om syntaxkonventioner.

Parametrar

Namn	Typ	Obligatorisk	Beskrivning
Källa	`string`	✔️	En tabelldatakälla. Se Tabelldatakällor.
Operator	`string`	✔️	Tabelldataoperatorer, till exempel filter och projektioner.
RenderInstruction	`string`		Återgivningsoperatorer eller instruktioner.

Tabelldatakällor

En tabelldatakälla skapar uppsättningar med poster som ska bearbetas ytterligare av tabelldataoperatorer. Följande lista visar tabelldatakällor som stöds:

Tabellreferenser
Operatorn för tabellintervall
Utskriftsoperatorn
Ett anrop av en funktion som returnerar en tabell
En tabellliteral ("datatabell")

Exempel

Filtrera rader efter villkor

Följande fråga räknar antalet poster i StormEvents tabellen som har värdet "FLORIDA" i State kolumnen.

Köra frågan

StormEvents 
| where State == "FLORIDA"
| count

Resultat

Antal
1042

Kombinera data från två tabeller

I följande exempel används kopplingsoperatorn för att kombinera poster från två tabelldatakällor: StormEvents tabellen och PopulationData tabellen.