Udostępnij za pośrednictwem

operator serializacji

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅✅

Oznacza, że kolejność zestawu wierszy wejściowych jest bezpieczna do użycia dla funkcji okna.

Operator ma znaczenie deklaratywne. Oznacza on zestaw wierszy wejściowych jako serializowany (uporządkowany), aby można było do niego zastosować funkcje okien.

Składnia

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

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
Nazwa/nazwisko string Nazwa kolumny do dodania lub zaktualizowania. W przypadku pominięcia nazwa kolumny wyjściowej jest generowana automatycznie.
Wyrażenie string ✔️ Obliczenie, które ma być wykonywane na danych wejściowych.

Przykłady

W przykładzie w tej sekcji pokazano, jak używać składni, aby ułatwić rozpoczęcie pracy.

Przykłady w tym artykule używają publicznie dostępnych tabel w pomocy klastra, takich jak tabela StormEvents w bazie danych przykładów.

Przykłady w tym artykule używają publicznie dostępnych tabel, takich jak tabela StormEvents w przykładowej analizie pogody przykładowych danych.

Serializowanie podzestawu wierszy według warunku

To zapytanie pobiera wszystkie wpisy dziennika z tabeli TraceLogs, która ma określony ClientRequestId i zachowuje kolejność tych wpisów podczas przetwarzania.

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

wyjściowe

W tej tabeli przedstawiono tylko 5 pierwszych wyników zapytania.

Sygnatury czasowej Węzeł Składnik ClientRequestId Komunikat
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 Pobieranie ścieżki pliku: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz""
2014-03-08T12:25:40.3574831Z Silnik00000000341 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: zakończona ścieżka pliku pozyskiwania: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz""
2014-03-08T12:25:40.9039588Z Silnik00000000341 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Pobieranie ścieżki pliku: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
2014-03-08T12:26:25.1684905Z Silnik000000000057 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: zakończona ścieżka pliku pozyskiwania: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
... ... ... ... ...

Dodawanie numeru wiersza do tabeli serializowanej

Aby dodać numer wiersza do tabeli serializowanej, użyj funkcji row_number().

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

wyjściowe

W tej tabeli przedstawiono tylko 5 pierwszych wyników zapytania.

Sygnatury czasowej Rn Węzeł Składnik ClientRequestId Komunikat
2014-03-08T13:00:01.6638235Z 1 Silnik000000000899 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: zakończona ścieżka pliku pozyskiwania: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_46.json.gz""
2014-03-08T13:00:02.2102992Z 2 Silnik000000000899 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Pobieranie ścieżki pliku: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz""
2014-03-08T13:00:46.4748309Z 3 Silnik000000000584 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: zakończona ścieżka pliku pozyskiwania: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz""
2014-03-08T13:00:47.0213066Z 4 Silnik000000000584 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Pobieranie ścieżki pliku: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
2014-03-08T13:01:31.2858383Z 5 Aparat000000000380 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: zakończona ścieżka pliku pozyskiwania: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
... ... ... ... ...

Zachowanie serializacji operatorów

Zestaw wierszy wyjściowych następujących operatorów jest oznaczony jako serializowany.

Zestaw wierszy wyjściowych następujących operatorów jest oznaczony jako nieserializowany.

Wszystkie inne operatory zachowują właściwość serializacji. Jeśli zestaw wierszy wejściowych jest serializowany, zestaw wierszy wyjściowych jest również serializowany.