highestCurrent() function

highestCurrent() selects the last record from each input table and returns the highest n records.

Note: highestCurrent() drops empty tables.

Function type signature
(<-tables: stream[A], n: int, ?column: string, ?groupColumns: [string]) => stream[A] where A: Record
For more information, see Function type signatures.



(Required) Number of records to return.


Column to evaluate. Default is _value.


List of columns to group by. Default is [].


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


Return the highest current value from a stream of tables

import "sampledata"
    |> highestCurrent(n: 1, groupColumns: ["tag"])

View example input and output

Was this page helpful?

Thank you for your feedback!

Linux Package Signing Key Rotation

All signed InfluxData Linux packages have been resigned with an updated key. If using Linux, you may need to update your package configuration to continue to download and verify InfluxData software packages.

For more information, see the Linux Package Signing Key Rotation blog post.