rename() function

rename() renames columns in a table.

If a column in group key is renamed, the column name in the group key is updated.

Function type signature
(<-tables: stream[B], ?columns: A, ?fn: (column: string) => string) => stream[C] where A: Record, B: Record, C: Record
For more information, see Function type signatures.



Record that maps old column names to new column names.


Function that takes the current column name (column) and returns a new column name.


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


Map column names to new column names

import "sampledata"
    |> rename(columns: {tag: "uid", _value: "val"})

View example input and ouput

Rename columns using a function

import "sampledata"
    |> rename(fn: (column) => "${column}_new")

View example input and ouput

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.