Partager via

serialize, opérateur

  • Article

S’applique à : ✅Microsoft Fabric✅✅

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. Il marque le jeu de lignes d’entrée comme sérialisé (ordonné), afin que les fonctions de fenêtre puissent être appliquées à celle-ci.

Syntaxe

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

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
Nom 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.

Exemples

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

Les exemples de cet article utilisent des tables disponibles publiquement dans le cluster d’aide, comme la table StormEvents dans la base de données Exemples.

Les exemples de cet article utilisent des tables disponibles publiquement, telles que la table StormEvents dans l’analyse météo exemples de données.

Sérialiser un sous-ensemble de lignes par condition

Cette requête récupère toutes les entrées de journal des TraceLogs table qui ont un clientRequestId spécifique et conserve l’ordre de ces entrées pendant le traitement.

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

de sortie

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

Horodatage Noeud Composant ClientRequestId Message
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 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

Pour ajouter un numéro de ligne à la table sérialisée, utilisez la fonction row_number().

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

de sortie

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

Horodatage Rn Noeud Composant ClientRequestId Message
2014-03-08T13:00:01.6638235Z 1 Engine00000000899 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 Engine00000000899 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 Engine00000000380 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é.