Partilhar via

Operador Serialize

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Marca que a ordem do conjunto de linhas de entrada é segura para uso para funções de janela.

O operador tem um significado declarativo. Ele marca o conjunto de linhas de entrada como serializado (ordenado), para que funções de janela possam ser aplicadas a ele.

Sintaxe

serialize [Nome1=Expr1 [,Nome2=Expr2]...]

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
Nome string O nome da coluna a ser adicionada ou atualizada. Se omitido, o nome da coluna de saída é gerado automaticamente.
Expr string ✔️ O cálculo a ser realizado sobre a entrada.

Exemplos

O exemplo nesta seção mostra como usar a sintaxe para ajudá-lo a começar.

Os exemplos neste artigo usam tabelas disponíveis publicamente no de cluster de ajuda, como a tabela StormEvents no banco de dados Samples.

Os exemplos neste artigo usam tabelas disponíveis publicamente, como a tabela StormEvents na análise do tempo dados de exemplo.

Serializar subconjunto de linhas por condição

Essa consulta recupera todas as entradas de log da tabela TraceLogs que têm um específico ClientRequestId e preserva a ordem dessas entradas durante o processamento.

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

Output

Esta tabela mostra apenas os 5 principais resultados da consulta.

Carimbo de data/hora Nó Componente ClientRequestId Mensagem
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 Download do caminho do arquivo: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz""
2014-03-08T12:25:40.3574831Z Motor000000000341 INGESTOR_EXECUTER 5A848F70-9996-EB17-15ED-21B8EB94BF0E IngestionCompletionEvent: caminho do arquivo de ingestão concluído: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz""
2014-03-08T12:25:40.9039588Z Motor000000000341 DOWNLOADER 5A848F70-9996-EB17-15ED-21B8EB94BF0E Download do caminho do arquivo: ""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: caminho do arquivo de ingestão concluído: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
... ... ... ... ...

Adicionar número de linha à tabela serializada

Para adicionar um número de linha à tabela serializada, use a função row_number().

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

Output

Esta tabela mostra apenas os 5 principais resultados da consulta.

Carimbo de data/hora RN Nó Componente ClientRequestId Mensagem
2014-03-08T13:00:01.6638235Z 1 Motor000000000899 INGESTOR_EXECUTER 5A848F70-9996-EB17-15ED-21B8EB94BF0E IngestionCompletionEvent: caminho do arquivo de ingestão concluído: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_46.json.gz""
2014-03-08T13:00:02.2102992Z 2 Motor000000000899 DOWNLOADER 5A848F70-9996-EB17-15ED-21B8EB94BF0E Download do caminho do arquivo: ""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: caminho do arquivo de ingestão concluído: ""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 Download do caminho do arquivo: ""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: caminho do arquivo de ingestão concluído: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
... ... ... ... ...

Comportamento de serialização de operadores

O conjunto de linhas de saída dos operadores a seguir é marcado como serializado.

O conjunto de linhas de saída dos operadores a seguir é marcado como não serializado.

Todos os outros operadores preservam a propriedade de serialização. Se o conjunto de linhas de entrada for serializado, o conjunto de linhas de saída também será serializado.