Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

super compile

super compile [ options ] query

Options

  • -C display DAG or AST as query text (default “false”)
  • -dag display output as DAG (implied by -O or -P) (default “false”)
  • -files compile query as if command-line input files are present) (default “false”)
  • -I source file containing query text (may be repeated)
  • -O display optimized DAG (default “false”)
  • -P display parallelized DAG (default “0”)
  • Global Options

Description

The super compile command allows detailed interactions with various stages of the query compiler.

This command parses a SuperSQL query and emits the resulting abstract syntax tree (AST) or runtime directed acyclic graph (DAG) in the output format desired. Use -dag to specify the DAG form; otherwise, the AST form is assumed.

The -C option causes the output to be shown as query language text instead of the AST. This is particularly helpful to see how SuperSQL queries in their abbreviated form are translated into the expanded, pedantic form of pipe queries. The DAG can also be formatted as query-style text but the resulting text is informational only and does not conform to any query syntax. When -C is specified, the result is sent to stdout and the -f and -o options have no effect.

This command is often used for dev and test but is also useful to advanced users for understanding how SuperSQL syntax is parsed into an AST or compiled into a runtime DAG.