distinct() function

distinct() returns all unique values in a specified column.

The _value of each output record is set to a distinct value in the specified column. null is considered its own distinct value if present.

Function type signature

(<-tables: stream[A], ?column: string) => stream[B] where A: Record, B: Record

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

column

Column to return unique values from. Default is _value.

tables

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

Examples

• Return distinct values from the _value column
• Return distinct values from a non-default column
• Return distinct values from data with null values

Return distinct values from the _value column

import "sampledata"

sampledata.int()
    |> distinct()

{{< expand-wrapper >}} {{% expand "View example input and output" %}}

Input data

Output data

{{% /expand %}} {{< /expand-wrapper >}}

Return distinct values from a non-default column

import "sampledata"

sampledata.int()
    |> distinct(column: "tag")

{{< expand-wrapper >}} {{% expand "View example input and output" %}}

Input data

Output data

{{% /expand %}} {{< /expand-wrapper >}}

Return distinct values from data with null values

import "sampledata"

sampledata.int(includeNull: true)
    |> distinct()

{{< expand-wrapper >}} {{% expand "View example input and output" %}}

Input data

Output data

{{% /expand %}} {{< /expand-wrapper >}}