Partager via

serialize, opérateur

  • Article

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

Sérialiser un sous-ensemble de lignes par condition

Exécuter la requête

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

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().

Exécuter la requête

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

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é.