BenchBox CLI Reference

Tags reference cli

This section provides comprehensive documentation for all BenchBox command-line interface (CLI) commands and options.

Global Options

These options are available for all BenchBox commands:

• --version: Show version information and exit

• --help: Show help message and exit

Commands Overview

BenchBox provides the following commands:

Command	Purpose	Documentation
run	Execute benchmarks with full configuration control	run
convert	Convert data to Parquet, Delta Lake, or Iceberg	convert
shell	Launch interactive SQL shell for database	shell
platforms	Manage database platform adapters	platforms
check-deps	Check dependency status and installation guidance	utilities
profile	Profile system resources	utilities
benchmarks	Manage benchmark suites	utilities
validate	Validate configuration files	utilities
tuning init	Generate sample tuning configurations	tuning
df-tuning	Manage DataFrame platform tuning configurations	tuning
export	Export benchmark results to various formats	results
results	Display exported benchmark results	results
compare	Compare benchmark results for regression detection	results

Quick Start

# Run a simple TPC-H benchmark on DuckDB
benchbox run --platform duckdb --benchmark tpch --scale 0.01

# Get help for any command
benchbox run --help
benchbox run --help-topic all       # All options including advanced
benchbox run --help-topic examples  # Categorized usage examples

Documentation Sections

CLI Commands

• run - Run Benchmarks
• convert - Convert Data Formats
• shell - Interactive SQL Shell
• platforms - Platform Management
• Utility Commands
• Tuning Commands
• Results Commands
• Configuration
• Common Workflows
• Troubleshooting