operador extend

  • Artigo

Cria colunas calculadas e acrescenta-as ao conjunto de resultados.

Syntax

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
T string ✔️ Entrada tabular a expandir.
ColumnName string Nome da coluna a adicionar ou atualizar.
Expression string ✔️ Cálculo a efetuar através da entrada.
  • Se ColumnName for omitido, o nome da coluna de saída de Expression é gerado automaticamente.
  • Se Expressão devolver mais do que uma coluna, pode ser especificada uma lista de nomes de coluna entre parênteses. Em seguida, as colunas de saída da Expressão recebem os nomes especificados. Se não for especificada uma lista dos nomes das colunas, todas as colunas de saída da Expressão com nomes gerados serão adicionadas à saída.

Devoluções

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

  1. Os nomes das colunas anotados pelo extend que já existem na entrada são removidos e acrescentados como os novos valores calculados.
  2. Os nomes de colunas anotados por extend que não existem na entrada são acrescentados como os novos valores calculados.

Nota

O extend operador adiciona uma nova coluna ao conjunto de resultados de entrada, que não tem um índice. Na maioria dos casos, se a nova coluna estiver definida para ser exatamente a mesma que uma coluna de tabela existente que tem um índice, o Kusto pode utilizar automaticamente o índice existente. No entanto, em alguns cenários complexos, esta propagação não é feita. Nesses casos, se o objetivo for mudar o nome de uma coluna, utilize o project-rename operador .

Exemplo

Executar a consulta

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

A tabela seguinte mostra apenas os primeiros 10 resultados. Para ver o resultado completo, execute a consulta.

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

Conteúdo relacionado