Condividi tramite

Operatore serialize

  • Articolo

Si applica a: ✅Microsoft Fabric✅

Contrassegna che l'ordine del set di righe di input è sicuro da usare per le funzioni finestra.

L'operatore ha un significato dichiarativo. Contrassegna il set di righe di input come serializzato (ordinato), in modo che le funzioni della finestra possano essere applicate.

Sintassi

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

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
Nome string Nome della colonna da aggiungere o aggiornare. Se omesso, il nome della colonna di output viene generato automaticamente.
Expr string ✔️ Calcolo da eseguire sull'input.

Esempi

L'esempio in questa sezione illustra come usare la sintassi per iniziare.

Gli esempi in questo articolo usano tabelle disponibili pubblicamente nel cluster della Guida , ad esempio la tabella StormEvents nel database degli esempi.

Gli esempi in questo articolo usano tabelle disponibili pubblicamente, ad esempio la tabella StormEvents in Analisi meteo dati di esempio.

Serializzare un subset di righe per condizione

Questa query recupera tutte le voci di log dalla tabella TraceLogs con una specifica ClientRequestId e mantiene l'ordine di queste voci durante l'elaborazione.

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

output

Questa tabella mostra solo i primi 5 risultati della query.

Timestamp Nodo Componente ClientRequestId Messaggio
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 Download del percorso del file: ""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: percorso del file di inserimento completato: ""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 Download del percorso del file: ""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: percorso del file di inserimento completato: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
... ... ... ... ...

Aggiungere il numero di riga alla tabella serializzata

Per aggiungere un numero di riga alla tabella serializzata, utilizzare la funzione row_number().

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

output

Questa tabella mostra solo i primi 5 risultati della query.

Timestamp Rn Nodo Componente ClientRequestId Messaggio
2014-03-08T13:00:01.6638235Z 1 Engine000000000899 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: percorso del file di inserimento completato: ""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 Download del percorso del file: ""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: percorso del file di inserimento completato: ""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 Download del percorso del file: ""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: percorso del file di inserimento completato: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
... ... ... ... ...

Comportamento di serializzazione degli operatori

Il set di righe di output degli operatori seguenti viene contrassegnato come serializzato.

Il set di righe di output degli operatori seguenti viene contrassegnato come nonrializzato.

Tutti gli altri operatori mantengono la proprietà di serializzazione. Se il set di righe di input viene serializzato, viene serializzato anche il set di righe di output.