Instrução TABULAR EXPRESSION

Artigo
01/23/2024

A instrução de expressão tabular é o que as pessoas geralmente têm em mente quando falam sobre consultas. Essa instrução geralmente aparece por último na lista de instruções, e sua entrada e sua saída consistem em tabelas ou conjuntos de dados tabulares. Duas instruções devem ser sempre separadas por ponto e vírgula.

Uma instrução de expressão tabular geralmente é composta por fontes de dados tabulares, como tabelas , operadores de dados tabulares , como filtros e projeções, e operadores de renderização opcionais. A composição é representada pelo caractere de pipe (|), dando à instrução uma forma 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 conjuntos de dados mais tabulares do corpo do operador, emite um conjunto de dados tabular para o próximo operador a seguir.

Syntax

Fonte|Operador1|Operador2|RenderInstruction

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
Origem	`string`	✔️	Uma fonte de dados tabular. Consulte Fontes de dados tabulares.
Operador	`string`	✔️	Operadores de dados tabulares, como filtros e projeções.
RenderInstruction	`string`		Renderizando operadores ou instruções.

Fontes de dados tabulares

Uma fonte de dados tabular produz conjuntos de registros, a serem processados por operadores de dados tabulares. A lista a seguir mostra as fontes de dados tabulares com suporte:

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

Exemplos

Filtrar linhas por condição

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

Executar a consulta

StormEvents 
| where State == "FLORIDA"
| count

Saída

Contagem
1042

Combinar dados de duas tabelas

No exemplo a seguir, o operador join é usado para combinar registros de duas fontes de dados tabulares: a StormEvents tabela e a PopulationData tabela.