Skip to main content

head

head [count]

Returns the top [count] results from subsequent results.

arguments:

count

The number of results to include. (type: string)

examples:

Query

seed '[{"key": "first"}, {"key": "second"}, {"key": "third"}]'
|| head 2

Results prior to head stage:

key
first
second
third

Results after head stage:

key
first
second

flags:

--appendStage

Used to append the results from a previous stage to the current stage. (provide a label, stage index, or boolean true to append the previous results)

--attributes

A comma separated list of attributes to include in the command results. If not provided, all attributes will be included.

--cache

A boolean value of true/false that determines whether or not to use the cache. Generally most commands will default to true.

--filter

A filter to run on the command results before completing the command. If not provided, no filter is run on the results.

--labelStage

Used to label a stage with a user provided label.

--stats

Controls if a stats calculation is run on a stage after it completes.