tableFind() function

tableFind() extracts the first table in a stream with group key values that match a specified predicate.

Function type signature

(<-tables: stream[B], fn: (key: A) => bool) => stream[B] where A: Record, B: Record

Parameters

fn

(Required) Predicate function to evaluate input table group keys.

tableFind() returns the first table that resolves as true. The predicate function requires a key argument that represents each input table’s group key as a record.

tables

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

Examples

Extract a table from a stream of tables

import "sampledata"

t =
    sampledata.int()
        |> tableFind(
            fn: (key) => key.tag == "t2",
        )// t represents the first table in a stream whose group key
// contains "tag" with a value of "t2".