download-answers - Answer Files

Pre-download TPC answer files for offline row-count validation of TPC-H and TPC-DS benchmark results.

Basic Syntax

benchbox download-answers [OPTIONS]

Options

--benchmark [tpch|tpcds|all]: Which benchmark’s answer files to download (default: all)
--force: Re-download even if files already exist in cache
--show-cache-dir: Print the cache directory path and exit. With --benchmark tpch or --benchmark tpcds, prints that benchmark’s subdirectory; with all (default), prints the parent cache directory.

Usage Examples

benchbox download-answers

benchbox download-answers --benchmark tpch

benchbox download-answers --force

benchbox download-answers --show-cache-dir
benchbox download-answers --show-cache-dir --benchmark tpch

The commands download both TPC-H and TPC-DS answer files, download only TPC-H, force a re-download, and show where answer files are cached.

Cache Location

Answer files are cached at $XDG_CACHE_HOME/benchbox/answers/ (or ~/.cache/benchbox/answers/ if XDG_CACHE_HOME is not set).

Environment Variables

Variable	Description
`BENCHBOX_ANSWERS_URL`	Override the default download URL for answer files
`BENCHBOX_NO_DOWNLOAD`	Set to `1` to disable all automatic downloads

Notes

Answer files are included in source distributions but not in wheel installs. This command bridges the gap for pip-installed users.
Answer files are used automatically during the validation phase of benchmark runs. Pre-downloading is optional but useful for air-gapped or CI environments.

run - Run benchmarks with validation