Instruções de expressão tabular

Artigo
01/18/2024

A instrução de expressão tabular é o que as pessoas geralmente têm em mente quando falam de consultas. Normalmente, esta instrução aparece em último lugar na lista de instruções e a entrada e o resultado são compostos por tabelas ou conjuntos de dados tabulares. As duas instruções têm de ser separadas por ponto e vírgula.

Uma instrução de expressão tabular é geralmente composta por origens de dados tabulares , como tabelas, operadores de dados tabulares , como filtros e projeções, e operadores de composição opcionais. A composição é representada pelo caráter de pipe (|), dando à instrução um formulário regular que representa visualmente o fluxo de dados tabulares da esquerda para a direita. Cada operador aceita um conjunto de dados tabular "do pipe" e outras entradas, incluindo mais conjuntos de dados tabulares do corpo do operador e, em seguida, emite um conjunto de dados tabular para o operador seguinte.

Syntax

Origem|Operador1|Operador2|RenderInstruction

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Necessário	Descrição
Origem	`string`	✔️	Uma origem de dados tabular. Veja Origens de dados tabulares.
Operador	`string`	✔️	Operadores de dados tabulares, como filtros e projeções.
RenderInstruction	`string`		Operadores de composição ou instruções.

Origens de dados tabulares

Uma origem de dados tabular produz conjuntos de registos, para serem processados por operadores de dados tabulares. A lista seguinte mostra as origens de dados tabulares suportadas:

Referências de tabela
O operador de intervalo tabular
O operador de impressão
Uma invocação de uma função que devolve uma tabela
Um literal de tabela ("datatable")

Exemplos

Filtrar linhas por condição

A consulta seguinte conta o número de registos na StormEvents tabela que têm um valor "FLORIDA" na State coluna.

Executar a consulta

StormEvents 
| where State == "FLORIDA"
| count

Saída

de palavras
1042

Combinar dados de duas tabelas

No exemplo seguinte, o operador de associação é utilizado para combinar registos de duas origens de dados tabulares: a StormEvents tabela e a PopulationData tabela.