Compartilhar 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 as funções de janela possam ser aplicadas a ele.

Sintaxe

serialize[=expr1 [ =expr2]...]

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória 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 executado 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 exemplos de.

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

Serializar subconjunto de linhas por condição

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

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

de saída

Esta tabela mostra apenas os cinco principais resultados da consulta.

Timestamp Nodo Componente ClientRequestId Mensagem
2014-03-08T12:24:55.5464757Z Mecanismo000000000757 INGESTOR_GATEWAY 5a848f70-9996-eb17-15ed-21b8eb94bf0e $$IngestionCommand table=fogEvents format=json
2014-03-08T12:24:56.0929514Z Mecanismo000000000757 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Baixar o caminho do arquivo: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz""
2014-03-08T12:25:40.3574831Z Mecanismo000000000341 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 Mecanismo000000000341 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Baixar o caminho do arquivo: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz""
2014-03-08T12:26:25.1684905Z Mecanismo000000000057 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()

de saída

Esta tabela mostra apenas os cinco principais resultados da consulta.

Timestamp Rn Nodo Componente ClientRequestId Mensagem
2014-03-08T13:00:01.6638235Z 1 Engine000000000899 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 Engine000000000899 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Baixar o caminho do arquivo: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz""
2014-03-08T13:00:46.4748309Z 3 Mecanismo000000000584 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 Mecanismo000000000584 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e Baixar o caminho do arquivo: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz""
2014-03-08T13:01:31.2858383Z 5 Mecanismo000000000380 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.