tail() function

The tail() function limits each output table to the last n records. The function produces one output table for each input table. Each output table contains the last n records before the offset. If the input table has less than offset + n records, tail() outputs all records before the offset.

tail(n: 10, offset: 0)



(Required) The maximum number of records to output.


The number of records to skip at the end of a table table before limiting to n. Default is 0.


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


The following example uses data provided by the sampledata package to show how tail() transforms data.

Output the last three rows in each input table

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

View input and output

Output the last three rows before the last row in each input table

import "sampledata"
    |> tail(n: 3, offset: 1)

View input and output

Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.