docs-v2/content/influxdb/cloud/reference/flux/stdlib/influxdb-v1/fieldsascols.md

1.7 KiB

title description aliases menu weight introduced deprecated
v1.fieldsAsCols() function The v1.fieldsAsCols() function pivots a table to automatically align fields within each input table that have the same timestamp.
/influxdb/cloud/reference/flux/functions/inputs/fromrows
/influxdb/cloud/reference/flux/functions/transformations/influxfieldsascols
/influxdb/cloud/reference/flux/functions/influxdb-v1/fieldsascols/
/influxdb/cloud/reference/flux/functions/influxdb-schema/fieldsascols/
influxdb_cloud_ref
name parent
v1.fieldsAsCols InfluxDB v1
301 0.16.0 0.88.0

{{% warn %}} v1.fieldsAsCols() was deprecated in Flux v0.88.0 in favor of schema.fieldsAsCols(). {{% /warn %}}

The v1.fieldsAsCols() function is a special application of the pivot() function that pivots on _field and _time columns to aligns fields within each input table that have the same timestamp. and resemble InfluxDB 1.x query output.

Function type: Transformation

import "influxdata/influxdb/v1"

v1.fieldsAsCols()

Examples

import "influxdata/influxdb/v1"

from(bucket:"example-bucket")
  |> range(start: -1h)
  |> filter(fn: (r) => r._measurement == "cpu")
  |> v1.fieldsAsCols()
  |> keep(columns: ["_time", "cpu", "usage_idle", "usage_user"])

Function definition

package v1

fieldsAsCols = (tables=<-) =>
  tables
    |> pivot(
      rowKey:["_time"],
      columnKey: ["_field"],
      valueColumn: "_value"
    )

Used functions: pivot()