Operador extend

  • Artículo

Crea columnas calculadas y las anexa al conjunto de resultados.

Syntax

T| extend [ColumnName | (ColumnName[, ...])=] Expresión [, ...]

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

Parámetros

Nombre Tipo Requerido Descripción
T string ✔️ Entrada tabular que se va a extender.
ColumnName string Nombre de la columna que se va a agregar o actualizar.
Expression string ✔️ Cálculo para realizar la entrada.
  • Si se omite ColumnName , el nombre de la columna de salida de Expression se genera automáticamente.
  • Si Expression devuelve más de una columna, se puede especificar una lista de nombres de columna entre paréntesis. A continuación, a las columnas de salida de Expression se les asignan los nombres especificados. Si no se especifica una lista de los nombres de columna, todas las columnas de salida de Expression con nombres generados se agregan a la salida.

Devoluciones

Copia del conjunto de resultados tabulares de entrada, de modo que:

  1. Los nombres de columna indicados por extend que ya existen en la entrada se quitan y se anexan como sus nuevos valores calculados.
  2. Los nombres de columna indicados por extend que no existen en la entrada se anexan como sus nuevos valores calculados.

Nota

El operador extend agrega una nueva columna al conjunto de resultados de entrada, que no tiene un índice. En la mayoría de los casos, si la nueva columna está configurada para ser exactamente igual a una columna de tabla existente que tiene un índice, Kusto puede usar automáticamente el índice existente. Sin embargo, en algunos escenarios complejos, esta propagación no se realiza. En tales casos, si el objetivo es cambiar el nombre de una columna, use en su lugar el operador project-rename.

Ejemplo

Ejecución de la consulta

StormEvents
| project EndTime, StartTime
| extend Duration = EndTime - StartTime

En la tabla siguiente solo se muestran los primeros 10 resultados. Para ver la salida completa, ejecute la consulta.

EndTime StartTime Duration
2007-01-01T00:00:00Z 2007-01-01T00:00:00Z 00:00:00
2007-01-01T00:25:00Z 2007-01-01T00:25:00Z 00:00:00
2007-01-01T02:24:00Z 2007-01-01T02:24:00Z 00:00:00
2007-01-01T03:45:00Z 2007-01-01T03:45:00Z 00:00:00
2007-01-01T04:35:00Z 2007-01-01T04:35:00Z 00:00:00
2007-01-01T04:37:00Z 2007-01-01T03:37:00Z 01:00:00
2007-01-01T05:00:00Z 2007-01-01T00:00:00Z 05:00:00
2007-01-01T05:00:00Z 2007-01-01T00:00:00Z 05:00:00
2007-01-01T06:00:00Z 2007-01-01T00:00:00Z 06:00:00
2007-01-01T06:00:00Z 2007-01-01T00:00:00Z 06:00:00

Contenido relacionado