KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

ccbench

★ 49 Open GitHub ↗

Concurrency Control Benchmark

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CCBench: Concurrency Control Protocol Workbench

![build](https://github.com/thawk105/ccbench/workflows/build/badge.svg)

CCBench re-implements major in-memory concurrency-control protocols on a common substrate so they can be compared on identical workloads. The original analysis paper is [Tanabe et al., VLDB 2020][1].

The repository now also bundles the **TPC-C** and **BoMB** workloads, and several additional protocols, contributed by [@jnmt](https://github.com/jnmt) on the [`vldb-paper`](https://github.com/jnmt/ccbench/tree/vldb-paper) branch and merged here.

| Protocol | YCSB | TPC-C | BoMB |
|---|:-:|:-:|:-:|
| Silo, MOCC, Cicada, ERMIA, TicToc, Oze, SI | ✓ | ✓ | ✓ |
| SS2PL, MVTO | — | ✓ | ✓ |
| D2PL | — | — | ✓ |

See [docs/workloads_en.md](docs/workloads_en.md) for the workload specs (tables, transactions, parameters) and [docs/protocols_en.md](docs/protocols_en.md) for the full protocol matrix.

[1]: http://www.vldb.org/pvldb/vol13/p3531-tanabe.pdf

## Quick start (devcontainer)

The repo ships with a `linux/amd64` devcontainer at [.devcontainer/](.devcontainer/) that pulls a prebuilt image from GHCR. In VS Code, run **`Dev Containers: Reopen in Container`** — apt deps are set up automatically.

Then inside the container:

```sh
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
```

CMake's FetchContent fetches and builds the third-party dependencies
(`masstree`, `mimalloc`, `googletest`) at configure time.

> On Apple Silicon the container runs under QEMU emulation: fine for development, **not** for benchmark numbers. Use a real x86_64 Linux host for measurements. See [docs/build_en.md](docs/build_en.md) for the full host setup.

## Run

Binaries land at `build/cc/<protocol>/<workload>_<protocol>.exe`. Examples:

```sh
./build/cc/silo/tpcc_silo.exe     -thread_num=8 -tpcc_num_wh=8
./build/cc/cicada/ycsb_cicada.exe -thread_num=8 -ycsb_rratio=50
./build/cc/silo/bomb_silo.exe     -thread_num=8 -bomb_mixed_mode -bomb_mixed_short_rate=1000
```

See `--help` for workload-specific flags, or [docs/runtime-args_en.md](docs/runtime-args_en.md) for the full reference.

## Documentation

- [docs/architecture_en.md](docs/architecture_en.md) — repo overview, TxExecutor API contract, GC rules
- [docs/build_en.md](docs/build_en.md) — host & devcontainer build instructions
- [docs/workloads_en.md](docs/workloads_en.md) — TPC-C / YCSB / BoMB specs
- [docs/protocols_en.md](docs/protocols_en.md) — protocol matrix and references
- [docs/runtime-args_en.md](docs/runtime-args_en.md) — runtime flag reference
- [docs/coding-conventions_en.md](docs/coding-conventions_en.md) — per-file-type conventions
- [docs/contributing_en.md](docs/contributing_en.md) — how to open issues / PRs / commits, doc-language rules
- [CLAUDE_en.md](CLAUDE_en.md) — repo-level context for AI assistants
- Original CCBench experimental data: <https://github.com/thawk105/ccdata>

## Acknowledgments

Takayuki Tanabe extends thanks to:

- Cybozu Labs Youth (8th term, 2018-04-10 – 2019-04-10) for supporting this work.
- Takashi Hoshino, advisor at Cybozu Labs Youth.
- Hideyuki Kawashima and Osamu Tatebe, supervisors.

## References

```
[1] Takayuki Tanabe, Takashi Hoshino, Hideyuki Kawashima, and Osamu Tatebe. 2020.
    An analysis of concurrency control protocols for in-memory databases with CCBench.
    Proc. VLDB Endow. 13, 13 (September 2020), 3531–3544.
    https://doi.org/10.14778/3424573.3424575
```

ccbench

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README