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

Parameters

n

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

columns

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

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

tables

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

Examples

Return rows with the three highest values in each input table

import "sampledata"

sampledata.int()
    |> top(n: 3)