YCSB/rocksdb
Xing Lin 49ce12a399
[rocksdb] change README to build just rocksdb binding (#1447)
change mvn build target to just build rocksdb-binding. This also makes the build command to be consistent with these for other bindings.
2020-11-27 02:07:35 -06:00
..
src [rocksdb] update version and add options (#1353) 2019-10-17 08:32:33 -05:00
README.md [rocksdb] change README to build just rocksdb binding (#1447) 2020-11-27 02:07:35 -06:00
pom.xml [version] update master branch to 0.18.0-SNAPSHOT 2019-09-21 01:24:50 -05:00

README.md

Quick Start

This section describes how to run YCSB on RocksDB running locally (within the same JVM). NOTE: RocksDB is an embedded database and so articles like How to run in parallel are not applicable here.

1. Set Up YCSB

Clone the YCSB git repository and compile:

git clone https://github.com/brianfrankcooper/YCSB.git
cd YCSB
mvn -pl site.ycsb:rocksdb-binding -am clean package

2. Run YCSB

Now you are ready to run! First, load the data:

./bin/ycsb load rocksdb -s -P workloads/workloada -p rocksdb.dir=/tmp/ycsb-rocksdb-data

Then, run the workload:

./bin/ycsb run rocksdb -s -P workloads/workloada -p rocksdb.dir=/tmp/ycsb-rocksdb-data

RocksDB Configuration Parameters

  • rocksdb.dir - (required) A path to a folder to hold the RocksDB data files.
    • EX. /tmp/ycsb-rocksdb-data
  • rocksdb.optionsfile - A path to a RocksDB options file.
    • EX. ycsb-rocksdb-options.ini

Note on RocksDB Options

If rocksdb.optionsfile is given, YCSB will apply all RocksDB options exactly as specified in the options file. Otherwise, YCSB will try to set reasonable defaults.