Partilhar via


Operador de extensão

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Cria colunas calculadas e as acrescenta ao conjunto de resultados.

Sintaxe

T| extend [ColumnName | (ColumnName[, ...])=] Expressão [, ...]

Saiba mais sobre convenções de sintaxe.

Parâmetros

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

Devoluções

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

  1. Os nomes de coluna observados pelos extend que já existem na entrada são removidos e acrescentados como seus 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 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 igual a uma coluna de tabela existente que tenha um índice, o Kusto poderá usar automaticamente o índice existente. No entanto, em alguns cenários complexos essa propagação não é feita. Nesses casos, se o objetivo for renomear uma coluna, use o project-rename operador em vez disso.

Exemplos

O exemplo a seguir mostra como usar o extend operador para criar uma nova coluna chamada Duration que calcula a diferença entre as EndTime colunas e StartTime na StormEvents tabela.

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.

Hora de término HoraDeInício Duração
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