Compartir a través de

Operador extend

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Crea columnas calculadas y las anexa al conjunto de resultados.

Sintaxis

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

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

Parámetros

Nombre Tipo Obligatorio Descripción
T string ✔️ Entrada tabular que se va a extender.
columnName string Nombre de la columna que se va a agregar o actualizar.
Expresión string ✔️ Cálculo para realizar la entrada.
  • Si se omite ColumnName , el nombre de 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, las columnas de salida de Expression reciben 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

Devuelve una copia del conjunto de resultados tabular 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.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el extend operador para crear una nueva columna denominada Duration que calcula la diferencia entre las EndTime columnas y StartTime de la StormEvents tabla.

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.

Hora de finalización HoraDeInicio Duración
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