Partilhar via


series_fill_forward()

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

Executa uma interpolação de preenchimento direto de valores ausentes em uma série.

Uma expressão que contém matriz numérica dinâmica é a entrada. A função substitui todas as instâncias de missing_value_placeholder pelo valor mais próximo de seu lado esquerdo diferente de missing_value_placeholder e retorna a matriz resultante. As instâncias mais à esquerda de missing_value_placeholder são preservadas.

Sintaxe

series_fill_forward( série, [ missing_value_placeholder ])

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
série dynamic ✔️ Uma matriz de valores numéricos.
missing_value_placeholder escalar Especifica um espaço reservado para valores ausentes. O valor padrão é double(null). O valor pode ser de qualquer tipo que possa ser convertido em tipos de elementos reais. double(null), long(null) e int(null) têm o mesmo significado.

Devoluções

série com todas as instâncias de missing_value_placeholder preenchidas para frente.

Observação

  • Se você criar série usando o operador make-series, especifique nulo como o valor padrão para usar funções de interpolação como series_fill_forward() depois. Ver explicação.
  • Se missing_value_placeholder for double(null) ou omitido, então um resultado pode conter valores de nulos. Para preencher esses valores de nulos, use outras funções de interpolação. Somente series_outliers() suporta valores de nulos em matrizes de entrada.
  • series_fill_forward() preserva o tipo original dos elementos da matriz.

Exemplo

O exemplo a seguir executa um preenchimento encaminhado em dados ausentes na tabela de dados, dados.

let data = datatable(arr: dynamic)
    [
    dynamic([null, null, 36, 41, null, null, 16, 61, 33, null, null])   
];
data 
| project
    arr, 
    fill_forward = series_fill_forward(arr)  

Output

arr fill_forward
[null,null,36,41,null,null,16,61,33,null,null] [nulo,nulo,36,41,41,41,16,61,33,33,33]

Use series_fill_backward ou series-fill-const para concluir a interpolação da matriz.