Skip to main content
Version: Next

unroll

Returns a new event for each member of a list in an event, duplicating the surrounding event.

unroll [field:list]

Description​

The unroll returns an event for each member of a specified list field, leaving the surrounding event unchanged.

Drops events where the specified field is null or an empty list.

field: list​

Sets the name of the list field.

Examples​

Unroll a list​

from [
  {x: "a", y: [1, 2, 3]},
  {x: "b", y: []},
  {x: "c", y: [4]},
]
unroll y
{x: "a", y: 1}
{x: "a", y: 2}
{x: "a", y: 3}
{x: "c", y: 4}