Documentation

yield() function

The yield() function indicates the input tables received should be delivered as a result of the query. Yield outputs the input stream unmodified. A query may have multiple results, each identified by the name provided to the yield() function.

Function type: Output
Output data type: Record

yield(name: "custom-name")

yield() is implicit for queries that do only one thing and are only needed when using multiple sources in a query. With multiple sources, yield() is required to specify what is returned, and what name to give it.

Parameters

name

A unique name for the yielded results. Defaults to "_results".

Data type: String

Examples

from(bucket: "example-bucket")
  |> range(start: -5m)
  |> yield(name: "1")

New! Cloud or OSS?

InfluxDB OSS 2.0 now generally available!

InfluxDB OSS 2.0 is now generally available and ready for production use. See the InfluxDB OSS 2.0 release notes.

For information about upgrading to InfluxDB OSS 2.0, see: