Skip to content

Global flags

Flags every iq command accepts, a query, iq inspect, iq diff, iq data drop alike.

Each one is documented on the page that owns its subject, and carries a there to mark that it works everywhere.

short long documented in
-s --src Sources
--config Configuration
-o --output Output
-C --color Output
-M --monochrome Output
--format.decimal Output
--no-cache Drivers
--no-cache-index Drivers
--no-progress Diagnostics & Logging
--log* Diagnostics & Logging
--error* Diagnostics & Logging
--debug.pprof Diagnostics & Logging
-v --verbose Diagnostics & Logging, plus Query plan for the formatted plan and Sources for the extra listing columns

The three below have no topic page of their own.

Timeout --timeout

Timeout for the whole operation, a query, a diff, a combine, or an --insert copy (default is 5s).

Help --help

Display help on the command line for iq.

Version --version

Prints the bare version and exits, with no name or prefix. As a result, a script can use it directly (v=$(iq --version)). The version has one of these forms:

  • v1.2.3 for a release build
  • The git-describe form (v1.2.3-14-gabc1234) for an untagged build
  • dev+<commit> only for a plain go build with no version metadata at all.

It always writes to stdout, unaffected by --output. For the human form (version, commit, build date, Go version), run iq version.

Not global

The query command carries flags of its own, --unbounded and --no-compile on Query data.

--explain on Query plan.

--from-format on Write data and the output-format and write families on their own pages.

iq combine and iq data carry their own copies of --unbounded/--explain where they apply.