Compartir a través de

Operador serialize

  • Artículo

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

Marca que el orden del conjunto de filas de entrada es seguro de usar para las funciones de ventana.

El operador tiene un significado declarativo. Marca el conjunto de filas de entrada como serializado (ordenado), de modo que las funciones de ventana se puedan aplicar a ella.

Sintaxis

serialize[Name1=Expr1 [,Name2 Expr2=]...]

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

Parámetros

Nombre Type Obligatorio Descripción
Nombre string El nombre de la columna que se va a agregar o actualizar. Si se omite, el nombre de la columna de salida se genera automáticamente.
Expr string ✔️ Cálculo que se va a realizar sobre la entrada.

Ejemplos

En el ejemplo de esta sección se muestra cómo usar la sintaxis para ayudarle a empezar.

En los ejemplos de este artículo se usan tablas disponibles públicamente en el clúster de , como la tabla StormEvents de la base de datos ejemplos de.

En los ejemplos de este artículo se usan tablas disponibles públicamente, como la tabla StormEvents del análisis meteorológico datos de ejemplo.

Serializar subconjunto de filas por condición

Esta consulta recupera todas las entradas de registro de la tabla traceLogs de que tienen un ClientRequestId específico y conserva el orden de estas entradas durante el procesamiento.

TraceLogs
| where ClientRequestId == "5a848f70-9996-eb17-15ed-21b8eb94bf0e"
| serialize

de salida

Esta tabla solo muestra los cinco primeros resultados de la consulta.

Timestamp Nodo Componente ClientRequestId Mensaje
2014-03-08T12:24:55.5464757Z Engine00000000757 INGESTOR_GATEWAY 5a848f70-9996-eb17-15ed-21b8eb94bf0e $$IngestionCommand table=fogEvents format=json
2014-03-08T12:24:56.0929514Z Engine00000000757 DESCARGADOR 5a848f70-9996-eb17-15ed-21b8eb94bf0e Descargar la ruta de acceso del archivo: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz""
2014-03-08T12:25:40.3574831Z Engine00000000341 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: ruta de acceso del archivo de ingesta finalizada: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz""
2014-03-08T12:25:40.9039588Z Engine00000000341 DESCARGADOR 5a848f70-9996-eb17-15ed-21b8eb94bf0e Descargar la ruta de acceso del archivo: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
2014-03-08T12:26:25.1684905Z Engine00000000057 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: ruta de acceso del archivo de ingesta finalizada: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
... ... ... ... ...

Adición de un número de fila a la tabla serializada

Para agregar un número de fila a la tabla serializada, use la función row_number().

TraceLogs
| where ClientRequestId == "5a848f70-9996-eb17-15ed-21b8eb94bf0e"
| serialize rn = row_number()

de salida

Esta tabla solo muestra los cinco primeros resultados de la consulta.

Timestamp Rn Nodo Componente ClientRequestId Mensaje
2014-03-08T13:00:01.6638235Z 1 Engine00000000899 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: ruta de acceso del archivo de ingesta finalizada: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_46.json.gz""
2014-03-08T13:00:02.2102992Z 2 Engine00000000899 DESCARGADOR 5a848f70-9996-eb17-15ed-21b8eb94bf0e Descargar la ruta de acceso del archivo: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz""
2014-03-08T13:00:46.4748309Z 3 Engine00000000584 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: ruta de acceso del archivo de ingesta finalizada: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz""
2014-03-08T13:00:47.0213066Z 4 Engine00000000584 DESCARGADOR 5a848f70-9996-eb17-15ed-21b8eb94bf0e Descargar la ruta de acceso del archivo: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
2014-03-08T13:01:31.2858383Z 5 Engine00000000380 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: ruta de acceso del archivo de ingesta finalizada: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
... ... ... ... ...

Comportamiento de serialización de operadores

El conjunto de filas de salida de los operadores siguientes se marca como serializado.

El conjunto de filas de salida de los operadores siguientes se marca como no serializado.

Todos los demás operadores conservan la propiedad de serialización. Si el conjunto de filas de entrada se serializa, el conjunto de filas de salida también se serializa.