Instruções de expressão tabular

Artigo
01/20/2025

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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 em último lugar na lista de instruções, e tanto sua entrada quanto sua saída consistem em tabelas ou conjuntos de dados tabulares. Quaisquer duas instruções devem ser 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 de 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 tubo", 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

Source|Operator1|Operator2|RenderInstruction

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação	Tipo	Necessário	Descrição
de 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 as fontes de dados tabulares suportadas:

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

Exemplos

No cluster de ajuda, há um banco de dados Samples com uma tabela StormEvents.

Filtrar linhas por condição

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

Executar a consulta

StormEvents 
| where State == "FLORIDA"
| count

Output

Contagem
1042

Combinar dados de duas tabelas

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