Dela via

serialisera operatorn

  • Artikel

Gäller för: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Markerar att ordningen på indataraduppsättningen är säker att använda för fönsterfunktioner.

Operatorn har en deklarativ betydelse. Den markerar indataraduppsättningen som serialiserad (ordnad), så att fönsterfunktioner kan tillämpas på den.

Syntax

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

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Krävs Beskrivning
namn string Namnet på kolumnen som ska läggas till eller uppdateras. Om det utelämnas genereras namnet på utdatakolumnen automatiskt.
uttr string ✔️ Beräkningen som ska utföras över indata.

Exempel

Exemplet i det här avsnittet visar hur du använder syntaxen för att komma igång.

Exemplen i den här artikeln använder offentligt tillgängliga tabeller i hjälpkluster, till exempel tabellen StormEvents i databasen Samples.

Exemplen i den här artikeln använder offentligt tillgängliga tabeller, till exempel tabellen StormEvents i Väderanalys exempeldata.

Serialisera delmängd av rader efter villkor

Den här frågan hämtar alla loggposter från tabellen TraceLogs som har en specifik ClientRequestId- och bevarar ordningen på dessa poster under bearbetningen.

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

utdata

Den här tabellen visar bara de 5 främsta frågeresultaten.

Tidsstämpel Nod Komponent ClientRequestId Meddelande
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 Ladda ned filsökväg: ""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: filsökväg för slutförd inmatning: ""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 Ladda ned filsökväg: ""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: filsökväg för slutförd inmatning: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
... ... ... ... ...

Lägg till radnummer i den serialiserade tabellen

Om du vill lägga till ett radnummer i den serialiserade tabellen använder du funktionen row_number().

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

utdata

Den här tabellen visar bara de 5 främsta frågeresultaten.

Tidsstämpel Rn Nod Komponent ClientRequestId Meddelande
2014-03-08T13:00:01.6638235Z 1 Engine000000000899 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: filsökväg för slutförd inmatning: ""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 Ladda ned filsökväg: ""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: filsökväg för slutförd inmatning: ""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 Ladda ned filsökväg: ""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: filsökväg för slutförd inmatning: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
... ... ... ... ...

Serialiseringsbeteende för operatorer

Raduppsättningen för utdata för följande operatorer är markerad som serialiserad.

Raduppsättningen för utdata för följande operatorer är markerad som icke-ialiserad.

Alla andra operatorer bevarar serialiseringsegenskapen. Om indataraduppsättningen serialiseras serialiseras även raduppsättningen för utdata.