sample() function
The sample() function selects a subset of the records from the input table.
Function type: Selector
Output data type: Object
sample(n:5, pos: -1)
Empty tables
sample() drops empty tables.
Parameters
n
Sample every Nth element.
Data type: Integer
pos
The position offset from the start of results where sampling begins.
pos must be less than n.
If pos is less than 0, a random offset is used.
Defaults to -1 (random offset).
Data type: Integer
Examples
from(bucket:"example-bucket")
|> range(start:-1d)
|> filter(fn: (r) =>
r._measurement == "cpu" and
r._field == "usage_system"
)
|> sample(n: 5, pos: 1)
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support or submit feedback, the following resources are available:
- Post in the InfluxData Community.
- Submit documentation issues to the InfluxDB 2.0 documentation repository.
- Submit InfluxDB issues to the InfluxDB repository.
For our InfluxDB Cloud customers, InfluxData Support is also available.