Freigeben über

serialize-Operator

  • Artikel

Gilt für: ✅Microsoft Fabric✅✅

Kennzeichnet, dass die Reihenfolge des Eingabezeilensatzes für Fensterfunktionen sicher verwendet werden kann.

Der Operator hat eine deklarative Bedeutung. Sie kennzeichnet die Eingabezeile als serialisiert (sortiert), sodass Fensterfunktionen darauf angewendet werden können.

Syntax

serialize[Name1= Ausdruck1 [ , Name2 Ausdruck2=]...]

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
Name string Der Name der hinzuzufügenden oder zu aktualisierenden Spalte. Wird der Ausgabespaltenname nicht angegeben, wird automatisch der Name der Ausgabespalte generiert.
Expr string ✔️ Die Berechnung, die über die Eingabe ausgeführt werden soll.

Beispiele

Das Beispiel in diesem Abschnitt zeigt, wie Sie die Syntax verwenden, um Ihnen bei den ersten Schritten zu helfen.

In den Beispielen in diesem Artikel werden öffentlich verfügbare Tabellen in der Hilfecluster-verwendet, z. B. die tabelle StormEvents in der datenbank Beispiele.

In den Beispielen in diesem Artikel werden öffentlich verfügbare Tabellen verwendet, z. B. die Tabelle StormEvents in der Wetteranalyse Beispieldaten.

Serialisieren einer Teilmenge von Zeilen nach Bedingung

Diese Abfrage ruft alle Protokolleinträge aus der TraceLogs- Tabelle ab, die eine bestimmte ClientRequestId- aufweisen und die Reihenfolge dieser Einträge während der Verarbeitung beibehalten.

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

Ausgabe-

In dieser Tabelle werden nur die 5 wichtigsten Abfrageergebnisse angezeigt.

Zeitstempel Knoten Bestandteil ClientRequestId Nachricht
2014-03-08T12:24:55.5464757Z Engine0000000000757 INGESTOR_GATEWAY 5a848f70-9996-eb17-15ed-21b8eb94bf0e $$IngestionCommand table=fogEvents format=json
2014-03-08T12:24:56.0929514Z Engine0000000000757 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Dateipfad wird heruntergeladen: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz""
2014-03-08T12:25:40.3574831Z Engine0000000000341 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: Abgeschlossener Aufnahmedateipfad: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz""
2014-03-08T12:25:40.9039588Z Engine0000000000341 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Dateipfad wird heruntergeladen: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
2014-03-08T12:26:25.1684905Z Engine0000000000057 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: Abgeschlossener Aufnahmedateipfad: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
... ... ... ... ...

Hinzufügen einer Zeilennummer zur serialisierten Tabelle

Verwenden Sie die funktion row_number() zum Hinzufügen einer Zeilennummer zur serialisierten Tabelle.

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

Ausgabe-

In dieser Tabelle werden nur die 5 wichtigsten Abfrageergebnisse angezeigt.

Zeitstempel Rn Knoten Bestandteil ClientRequestId Nachricht
2014-03-08T13:00:01.6638235Z 1 Engine0000000000899 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: Abgeschlossener Aufnahmedateipfad: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_46.json.gz""
2014-03-08T13:00:02.2102992Z 2 Engine0000000000899 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Dateipfad wird heruntergeladen: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz""
2014-03-08T13:00:46.4748309Z 3 Engine0000000000584 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: Abgeschlossener Aufnahmedateipfad: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz""
2014-03-08T13:00:47.0213066Z 4 Engine0000000000584 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Dateipfad wird heruntergeladen: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
2014-03-08T13:01:31.2858383Z 5 Engine0000000000380 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: Abgeschlossener Aufnahmedateipfad: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
... ... ... ... ...

Serialisierungsverhalten von Operatoren

Der Ausgabezeilensatz der folgenden Operatoren wird als serialisiert markiert.

Der Ausgabezeilensatz der folgenden Operatoren wird als nicht ialisiert markiert.

Alle anderen Operatoren behalten die Serialisierungseigenschaft bei. Wenn der Eingabezeilensatz serialisiert wird, wird der Ausgabezeilensatz ebenfalls serialisiert.