Delen via

operator serialiseren

  • Artikel

Van toepassing op: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel-

Hiermee wordt aangegeven dat de volgorde van de invoerrijset veilig is voor vensterfuncties.

De operator heeft een declaratieve betekenis. Hiermee wordt de invoerrijset gemarkeerd als geserialiseerd (geordend), zodat vensterfuncties erop kunnen worden toegepast.

Syntaxis

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

Meer informatie over syntaxisconventies.

Parameters

Naam Type Vereist Beschrijving
naam string De naam van de kolom die moet worden toegevoegd of bijgewerkt. Als u dit weglaat, wordt de naam van de uitvoerkolom automatisch gegenereerd.
Expr- string ✔️ De berekening die moet worden uitgevoerd voor de invoer.

Voorbeelden

In het voorbeeld in deze sectie ziet u hoe u de syntaxis gebruikt om aan de slag te gaan.

In de voorbeelden in dit artikel worden openbaar beschikbare tabellen gebruikt in de Help-cluster, zoals de StormEvents tabel in de Voorbeelden database.

In de voorbeelden in dit artikel worden openbaar beschikbare tabellen gebruikt, zoals de tabel StormEvents in de weather analytics voorbeeldgegevens.

Subset van rijen op voorwaarde serialiseren

Met deze query worden alle logboekvermeldingen opgehaald uit de TraceLogs tabel met een specifieke ClientRequestId en blijft de volgorde van deze vermeldingen behouden tijdens de verwerking.

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

uitvoer

In deze tabel worden alleen de top 5 queryresultaten weergegeven.

Tijdstempel Knoop Bestanddeel ClientRequestId Bericht
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 Bestandspad downloaden: ""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: voltooid pad naar opnamebestand: ""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 Bestandspad downloaden: ""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: voltooid pad naar opnamebestand: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
... ... ... ... ...

Rijnummer toevoegen aan de geserialiseerde tabel

Als u een rijnummer wilt toevoegen aan de geserialiseerde tabel, gebruikt u de functie row_number().

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

uitvoer

In deze tabel worden alleen de top 5 queryresultaten weergegeven.

Tijdstempel Rn Knoop Bestanddeel ClientRequestId Bericht
2014-03-08T13:00:01.6638235Z 1 Engine000000000899 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: voltooid pad naar opnamebestand: ""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 Bestandspad downloaden: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz""
2014-03-08T13:00:46.4748309Z 3 Engine00000000584 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent: voltooid pad naar opnamebestand: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz""
2014-03-08T13:00:47.0213066Z 4 Engine00000000584 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Bestandspad downloaden: ""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: voltooid pad naar opnamebestand: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
... ... ... ... ...

Serialisatiegedrag van operators

De uitvoerrijset van de volgende operators wordt gemarkeerd als geserialiseerd.

De uitvoerrijset van de volgende operators is gemarkeerd als niet-geserialiseerd.

Alle andere operators behouden de serialisatie-eigenschap. Als de invoerrijset is geserialiseerd, wordt de uitvoerrijset ook geserialiseerd.