Instrucciones de expresiones tabulares

  • Artículo

La instrucción de expresión tabular es lo que las personas suelen tener en cuenta cuando hablan sobre las consultas. Esta instrucción suele aparecer en último lugar en la lista de instrucciones, y tanto su entrada como su salida constan de tablas o conjuntos de datos tabulares. Las instrucciones deben estar separadas por un punto y coma.

Normalmente, una instrucción de expresión tabular se compone de orígenes de datos tabulares , como tablas, operadores de datos tabulares , como filtros y proyecciones, y operadores de representación opcionales. La composición se representa mediante el carácter de canalización (|), lo que proporciona a la instrucción una forma regular que representa visualmente el flujo de datos tabulares de izquierda a derecha. Cada operador acepta un conjunto de datos tabular "de la canalización" y otras entradas, incluidos más conjuntos de datos tabulares del cuerpo del operador y, a continuación, emite un conjunto de datos tabular al operador siguiente.

Syntax

Fuente|Operator1|Operator2|RenderInstruction

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Tipo Requerido Descripción
Origen string ✔️ Un origen de datos tabular. Consulte Orígenes de datos tabulares.
Operador string ✔️ Operadores de datos tabulares, como filtros y proyecciones.
RenderInstruction string Operadores de representación o instrucciones.

Orígenes de datos tabulares

Un origen de datos tabular genera conjuntos de registros para que los operadores de datos tabulares los procesen aún más. En la lista siguiente se muestran los orígenes de datos tabulares admitidos:

  • Referencias de tabla
  • Operador de intervalo tabular
  • Operador print
  • Invocación de una función que devuelve una tabla
  • Un literal de tabla ("datatable")

Ejemplos

Filtrar filas por condición

La consulta siguiente cuenta el número de registros de la StormEvents tabla que tienen un valor de "FLORIDA" en la State columna.

Ejecución de la consulta

StormEvents 
| where State == "FLORIDA"
| count

Salida

Count
1042

Combinar datos de dos tablas

En el ejemplo siguiente, el operador join se usa para combinar registros de dos orígenes de datos tabulares: la StormEvents tabla y la PopulationData tabla.

Ejecución de la consulta

StormEvents 
| where InjuriesDirect + InjuriesIndirect > 50
| join (PopulationData) on State
| project State, Population, TotalInjuries = InjuriesDirect + InjuriesIndirect

Salida

State Población TotalInjuries
ALABAMA 4918690 60
CALIFORNIA 39562900 61
KANSAS 2915270 63
MISURI 6153230 422
OKLAHOMA 3973710 200
TENNESSEE 6886720 187
TEXAS 29363100 137