Partilhar via


series_fill_const()

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

Substitui os valores ausentes em uma série por um valor constante especificado.

Usa uma expressão que contém matriz numérica dinâmica como entrada, substitui todas as instâncias de missing_value_placeholder pela constant_value especificada e retorna a matriz resultante.

Sintaxe

series_fill_const( série,constant_value, [ 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.
constant_value escalar ✔️ O valor usado para substituir os valores ausentes.
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 é 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 substituídas por constant_value.

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_const() depois. Ver explicação.
  • Se missing_value_placeholder for double(null) ou omitido, então um resultado 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_const() preserva o tipo original dos elementos da matriz.

Exemplo

O exemplo a seguir substitui os valores ausentes na tabela de dados, dados, pelo valor 0,0 na coluna fill_const1 e pelo valor -1 na coluna fill_const2.

let data = datatable(arr: dynamic)
    [
    dynamic([111, null, 36, 41, 23, null, 16, 61, 33, null, null])   
];
data 
| project
    arr, 
    fill_const1 = series_fill_const(arr, 0.0),
    fill_const2 = series_fill_const(arr, -1)  

Output

arr fill_const1 fill_const2
[111,null,36,41,23,null,16,61,33,null,null] [111,0.0,36,41,23,0.0,16,61,33,0.0,0.0] [111,-1,36,41,23,-1,16,61,33,-1,-1]