Documentation

fill() function

fill() is experimental and subject to change at any time. By using this function, you accept the risks of experimental functions.

fill() replaces all null values in input tables with a non-null value.

Note: universe.fill() is an experimental function with a more precise type signature.

Output tables are the same as the input tables with all null values replaced in the specified column.

Function type signature
(<-tables: stream[{C with A: B}], ?column: A = "_value", ?usePrevious: bool, ?value: B) => stream[{C with A: B}] where A: Label, C: Record
For more information, see Function type signatures.

Parameters

column

Column to replace null values in. Default is _value.

value

Constant value to replace null values with.

Value type must match the type of the specified column.

usePrevious

Replace null values with the previous non-null value. Default is false.

tables

Input data. Default is piped-forward data (<-).

Examples

Fill null values with a specified non-null value

import "experimental/universe"
import "sampledata"

sampledata.int(includeNull: true)
    |> universe.fill(value: 0)

View example input and ouput

Fill null values with the previous non-null value

import "experimental/universe"
import "sampledata"

sampledata.int(includeNull: true)
    |> universe.fill(usePrevious: true)

View example input and ouput


Was this page helpful?

Thank you for your feedback!


Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.