Concepts
Conceptual documentation explaining BenchBox architecture, terminology, and design principles.
Core Concepts
- Architecture - System architecture and component overview
- Workflow - Benchmark execution workflow and lifecycle
- Data Model - Data structures and relationships
- Glossary - Terms and definitions
Comparisons
- Benchmarking Tools Compared - BenchBox vs HammerDB, BenchBase, and LakeBench
Understanding BenchBox
BenchBox is designed around a few key concepts:
Benchmarks
Standard workloads that test database performance across different dimensions (analytics, transactions, data loading).
Platforms
Database adapters that execute benchmarks on specific database systems (DuckDB, Databricks, Snowflake, etc.).
Execution Modes
Different ways to run benchmarks:
- Power Test: Sequential query execution measuring single-user performance
- Throughput Test: Concurrent query streams measuring multi-user scalability
- Data Generation: Creating benchmark datasets at various scale factors
Results & Validation
Structured output capturing execution metrics, query timings, and optional validation against expected results.
Related Documentation
- Getting Started - Start using BenchBox
- Design Documents - Detailed design specifications
- Development Guide - Contributing to BenchBox