branch

branch

Starts a new branch, all stages following the branch command will be run on the root of the first branch, until another branch command or a mergebranches command.

examples:

Query

seed '[{"key": "value"}]'
|| branch
  || addcolumn branch 1
|| branch
  || addcolumn branch 2
|| mergebranches

Results prior to branch stage:

key
value

Results after branch stage:

key	branch
value	1
value	2

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.

--fresh

Starts the branch as if it was a fresh query, so will not use results from prior to the first branch.

--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.