Skip to main content
Version: v1.3.0

sample

Operator

sample select one value of each shape

Synopsis

sample [<expr>]

Description

The sample operator is a syntactic shortcut for

val:=any(<expr>) by typeof(<expr>) | yield val

If <expr> is not provided, this is used.

In other words, sample produces one value of each type in the input. This is useful for data exploration when you want to see the shapes of data and some sample data in a data set without having to sift through it all to slice and dice it.

Examples

A simple sample

echo '1 2 3 "foo" "bar" 10.0.0.1 10.0.0.2' | zq -z 'sample | sort this' -

=>

1
10.0.0.1
"foo"

Sampling record shapes

echo '{a:1}{a:2}{s:"foo"}{s:"bar"}{a:3,s:"baz"}' | zq -z 'sample | sort a' -

=>

{a:1}
{a:3,s:"baz"}
{s:"foo"}