tableFind() function

The tableFind() function extracts the first table in a stream of tables whose group key values match a predicate. If no table is found, the function errors.

tableFind(fn: (key) => key._field == "fieldName")


Make sure fn parameter names match each specified parameter. To learn why, see Match parameter names.


A predicate function for matching keys in a table’s group key. tableFind returns the first table that resolves as true. Expects a key argument that represents a group key in the input stream.

Example fn function
(key) => key._field == "fieldName"


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


The following example uses data provided by the sampledata package to show how tableFind() transforms data.

import "sampledata"

t =
    |> tableFind(fn: (key) => key.tag == "t2")

// t represents the first table in a stream whose group key
// contains "tag" with a value of "t2".

You can use t from the example above as input for getColumn() and getRecord().

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.