Instrução TABULAR EXPRESSION

Artigo
07/03/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 tanto sua entrada quanto 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 de 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 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 mais conjuntos de dados tabulares do corpo do operador, em seguida, emite um conjunto de dados tabular para o próximo operador que se segue.

Sintaxe

Operador de origem1 | | Operador2 | RenderInstruction

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	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`		Operadores de renderização ou instruções.

Fontes de dados tabulares

Uma fonte de dados tabular produz conjuntos de registros, a serem processados posteriormente por operadores de dados tabulares. A lista a seguir mostra 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 de "FLORIDA" na State coluna.

Executar a consulta

StormEvents 
| where State == "FLORIDA"
| count

Saída

Count
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.