Documentation function

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

The function introduces an extend mode to the existing group() function.

Function type: Transformation

This function will be removed once the proposed extend mode is sufficiently vetted.

import "experimental" ["host", "_measurement"], mode:"extend")



List of columns to use in the grouping operation. Defaults to [].

Data type: Array of strings


The mode used to group columns.

Data type: String

extend is the only mode available to


Appends columns defined in the columns parameter to all existing group keys.


Include the value column in each groups' group key
import "experimental"

from(bucket: "example-bucket")
  |> range(start: -1m)
  |> ["_value"], mode: "extend")

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: