Sdílet prostřednictvím

Operátor serialize

  • Článek

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Označí, že pořadí sady vstupních řádků je bezpečné použít pro funkce oken.

Operátor má deklarativní význam. Označí vstupní řádek nastavený jako serializovaný (seřazený), aby na něj bylo možné použít funkce okna.

Syntaxe

serialize[Název1= Výraz1 [,Name2 = Výraz2]...]

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Type Požadováno Popis
Jméno string Název sloupce, který chcete přidat nebo aktualizovat. Pokud název výstupního sloupce vynecháte, automaticky se vygeneruje.
Výraz string ✔️ Výpočet, který se má provést přes vstup.

Příklady

Příklad v této části ukazuje, jak použít syntaxi, která vám pomůže začít.

Příklady v tomto článku používají veřejně dostupné tabulky v clusteru nápovědy, jako je StormEvents tabulka v databázi Ukázky.

Příklady v tomto článku používají veřejně dostupné tabulky, jako je tabulka StormEvents v analýze počasí, ukázková data.

Serializace podmnožina řádků podle podmínky

Tento dotaz načte všechny položky protokolu z tabulky TraceLogs, které mají konkrétní ClientRequestId a během zpracování zachová pořadí těchto položek.

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

výstupní

Tato tabulka zobrazuje pouze prvních 5 výsledků dotazu.

Časová značka Uzel Komponenta ClientRequestId Zpráva
2014-03-08T12:24:55.5464757Z Motor000000000757 INGESTOR_GATEWAY 5a848f70-9996-eb17-15ed-21b8eb94bf0e $$IngestionCommand table=fogEvents format=json
2014-03-08T12:24:56.0929514Z Motor000000000757 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Stažení cesty k souboru: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz""
2014-03-08T12:25:40.3574831Z Modul 000000000341 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: dokončená cesta k souboru příjmu dat: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz""
2014-03-08T12:25:40.9039588Z Modul 000000000341 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Stažení cesty k souboru: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
2014-03-08T12:26:25.1684905Z Motor000000000057 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: dokončená cesta k souboru příjmu dat: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
... ... ... ... ...

Přidání čísla řádku do serializované tabulky

K přidání čísla řádku do serializované tabulky použijte funkci row_number().

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

výstupní

Tato tabulka zobrazuje pouze prvních 5 výsledků dotazu.

Časová značka Rn Uzel Komponenta ClientRequestId Zpráva
2014-03-08T13:00:01.6638235Z 1 Motor00000000899 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: dokončená cesta k souboru příjmu dat: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_46.json.gz""
2014-03-08T13:00:02.2102992Z 2 Motor00000000899 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Stažení cesty k souboru: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz""
2014-03-08T13:00:46.4748309Z 3 Motor000000000584 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: dokončená cesta k souboru příjmu dat: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz""
2014-03-08T13:00:47.0213066Z 4 Motor000000000584 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Stažení cesty k souboru: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
2014-03-08T13:01:31.2858383Z 5 Motor000000000380 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: dokončená cesta k souboru příjmu dat: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
... ... ... ... ...

Chování serializace operátorů

Výstupní sada řádků následujících operátorů je označena jako serializovaná.

Výstupní sada řádků následujících operátorů je označena jako neserializovaná.

Všechny ostatní operátory zachová vlastnost serializace. Pokud je vstupní sada řádků serializována, je sada výstupních řádků také serializována.