operador extend

  • Artigo

Cria colunas calculadas e as acrescenta ao conjunto de resultados.

Syntax

T| extend [ColumnName | (ColumnName[, ...])=] Expression [, ...]

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
T string ✔️ Entrada tabular a ser estendida.
ColumnName string Nome da coluna a ser adicionada ou atualizada.
Expression string ✔️ Cálculo a ser executado na entrada.
  • Se ColumnName for omitido, o nome da coluna de saída de Expression será gerado automaticamente.
  • Se Expression retornar mais de uma coluna, uma lista de nomes de coluna poderá ser especificada entre parênteses. Em seguida, as colunas de saída da Expressão recebem os nomes especificados. Se uma lista de nomes de coluna não for especificada, todas as colunas de saída da Expressão com nomes gerados serão adicionadas à saída.

Retornos

Uma cópia do conjunto de resultados tabulares de entrada, de modo que:

  1. Os nomes de coluna indicados por extend que já existem na entrada são removidos e acrescentados como novos valores calculados.
  2. Os nomes de coluna observados por extend que não existem na entrada são acrescentados como seus novos valores calculados.

Observação

O operador extend acrescenta uma nova coluna ao conjunto de resultados de entrada, que não tem um índice. Na maioria dos casos, se a nova coluna estiver configurada exatamente igual a uma coluna atual na tabela que tenha um índice, o Azure Data Explorer poderá usar automaticamente o índice existente. No entanto, em alguns cenários complexos, essa propagação não é feita. Nesses casos, se a meta for renomear uma coluna, use o operador project-rename em vez disso.

Exemplo

Executar a consulta

StormEvents
| project EndTime, StartTime
| extend Duration = EndTime - StartTime

A tabela a seguir mostra apenas os primeiros 10 resultados. Para ver a saída completa, execute a consulta.

EndTime StartTime Duration
2007-01-01T00:00:00Z 2007-01-01T00:00:00Z 00:00:00
2007-01-01T00:25:00Z 2007-01-01T00:25:00Z 00:00:00
2007-01-01T02:24:00Z 2007-01-01T02:24:00Z 00:00:00
2007-01-01T03:45:00Z 2007-01-01T03:45:00Z 00:00:00
2007-01-01T04:35:00Z 2007-01-01T04:35:00Z 00:00:00
2007-01-01T04:37:00Z 2007-01-01T03:37:00Z 01:00:00
2007-01-01T05:00:00Z 2007-01-01T00:00:00Z 05:00:00
2007-01-01T05:00:00Z 2007-01-01T00:00:00Z 05:00:00
2007-01-01T06:00:00Z 2007-01-01T00:00:00Z 06:00:00
2007-01-01T06:00:00Z 2007-01-01T00:00:00Z 06:00:00

Conteúdo relacionado