Partager via

serialize operator

Applies to: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Marque que l’ordre de l’ensemble de lignes d’entrée est sûr à utiliser pour les fonctions de fenêtre.

L’opérateur a une signification déclarative. It marks the input row set as serialized (ordered), so that window functions can be applied to it.

Syntax

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

Learn more about syntax conventions.

Parameters

Name Type Required Description
Name string Nom de la colonne à ajouter ou mettre à jour. S’il est omis, le nom de la colonne de sortie est généré automatiquement.
Expr string ✔️ Calcul à effectuer sur l’entrée.

Examples

L’exemple de cette section montre comment utiliser la syntaxe pour vous aider à commencer.

The examples in this article use publicly available tables in the help cluster, such as the StormEvents table in the Samples database.

The examples in this article use publicly available tables, such as the Weather table in the Weather analytics sample gallery. Vous devrez peut-être modifier le nom de la table dans l’exemple de requête pour qu’elle corresponde à la table de votre espace de travail.

Sérialiser un sous-ensemble de lignes par condition

This query retrieves all log entries from the TraceLogs table that have a specific ClientRequestId and preserves the order of these entries during processing.

Exécuter la requête

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

Output

Ce tableau affiche uniquement les 5 premiers résultats de la requête.

Timestamp Node Component ClientRequestId Message
2014-03-08T12:24:55.5464757Z Engine000000000757 INGESTOR_GATEWAY 5a848f70-9996-eb17-15ed-21b8eb94bf0e $$IngestionCommand table=fogEvents format=json
2014-03-08T12:24:56.0929514Z Engine000000000757 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Téléchargement du chemin d’accès au fichier : « »https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz" »
2014-03-08T12:25:40.3574831Z Engine000000000341 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent : chemin d’accès du fichier d’ingestion terminé : « »https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz" »
2014-03-08T12:25:40.9039588Z Engine000000000341 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Téléchargement du chemin d’accès au fichier : « »https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz" »
2014-03-08T12:26:25.1684905Z Engine000000000057 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent : chemin d’accès du fichier d’ingestion terminé : « »https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz" »
... ... ... ... ...

Ajouter un numéro de ligne à la table sérialisée

To add a row number to the serialized table, use the row_number() function.

Exécuter la requête

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

Output

Ce tableau affiche uniquement les 5 premiers résultats de la requête.

Timestamp rn Node Component ClientRequestId Message
2014-03-08T13:00:01.6638235Z 1 Engine000000000899 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent : chemin d’accès du fichier d’ingestion terminé : « »https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_46.json.gz" »
2014-03-08T13:00:02.2102992Z 2 Engine000000000899 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Téléchargement du chemin d’accès au fichier : « »https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz" »
2014-03-08T13:00:46.4748309Z 3 Engine000000000584 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent : chemin d’accès du fichier d’ingestion terminé : « »https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz" »
2014-03-08T13:00:47.0213066Z 4 Engine000000000584 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Téléchargement du chemin d’accès au fichier : « »https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz" »
2014-03-08T13:01:31.2858383Z 5 Engine000000000380 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent : chemin d’accès du fichier d’ingestion terminé : « »https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz" »
... ... ... ... ...

Comportement de sérialisation des opérateurs

L’ensemble de lignes de sortie des opérateurs suivants est marqué comme sérialisé.

L’ensemble de lignes de sortie des opérateurs suivants est marqué comme non non défini.

Tous les autres opérateurs conservent la propriété de sérialisation. Si le jeu de lignes d’entrée est sérialisé, le jeu de lignes de sortie est également sérialisé.

  • Last updated on