top() function

top() sorts each input table by specified columns and keeps the top n records in each table.

Note: top() drops empty tables.

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



(Required) Number of rows to return from each input table.


List of columns to sort by. Default is ["_value"].

Sort precedence is determined by list order (left to right).


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


Return rows with the three highest values in each input table

import "sampledata"
    |> top(n: 3)

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.