rocksdb

fork of https://github.com/oxigraph/rocksdb and https://github.com/facebook/rocksdb for nextgraph and oxigraph

Zhichao Cao 8ea087ad16 Workload generator (Mixgraph) based on prefix hotness (#5953 ) Summary: In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = aexp(bx) + cexp(dx)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters. For example: `./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48` Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953 Test Plan: run db_bench with different parameters and checked the results. Differential Revision: D18053527 Pulled By: zhichao-cao fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7		5 years ago
buckifier	Add clarifying/instructive header to TARGETS and defs.bzl	5 years ago
build_tools	Misc hashing updates / upgrades (#5909 )	5 years ago
cache	Misc hashing updates / upgrades (#5909 )	5 years ago
cmake	cmake: s/SNAPPY_LIBRARIES/snappy_LIBRARIES/ (#5687 )	5 years ago
coverage	Fix interpreter lines for files with python2-only syntax.	6 years ago
db	Add a limited support for iteration bounds into BaseDeltaIterator (#5403 )	5 years ago
docs	Blog post for write_unprepared (#5711 )	5 years ago
env	Add Env::SanitizeEnvOptions (#5885 )	5 years ago
examples	Apply formatter to recent 200+ commits. (#5830 )	5 years ago
file	Apply formatter to recent 200+ commits. (#5830 )	5 years ago
hdfs	Add copyright headers per FB open-source checkup tool. (#5199 )	6 years ago
include/rocksdb	Rename BlockBasedTable::ReadMetaBlock (#6009 )	5 years ago
java	Fix the rocksjava release Vagrant build on CentOS (#5901 )	5 years ago
logging	Apply formatter to recent 200+ commits. (#5830 )	5 years ago
memory	Charge block cache for cache internal usage (#5797 )	5 years ago
memtable	Misc hashing updates / upgrades (#5909 )	5 years ago
monitoring	Apply formatter to recent 200+ commits. (#5830 )	5 years ago
options	Apply formatter to recent 200+ commits. (#5830 )	5 years ago
port	Fix block cache ID uniqueness for Windows builds (#5844 )	5 years ago
table	Rename BlockBasedTable::ReadMetaBlock (#6009 )	5 years ago
test_util	Apply formatter to recent 200+ commits. (#5830 )	5 years ago
third-party	Refactor/consolidate legacy Bloom implementation details (#5784 )	5 years ago
tools	Workload generator (Mixgraph) based on prefix hotness (#5953 )	5 years ago
trace_replay	Misc hashing updates / upgrades (#5909 )	5 years ago
util	Add new persistent 64-bit hash (#5984 )	5 years ago
utilities	Rename BlockBasedTable::ReadMetaBlock (#6009 )	5 years ago
.clang-format	A script that automatically reformat affected lines	11 years ago
.gitignore	Make buckifier python3 compatible (#5922 )	5 years ago
.lgtm.yml	Create lgtm.yml for LGTM.com C/C++ analysis (#4058 )	7 years ago
.travis.yml	Remove a webhook due to potential security concern (#5902 )	5 years ago
.watchmanconfig	Added .watchmanconfig file to rocksdb repo (#5593 )	6 years ago
AUTHORS	Update RocksDB Authors File	7 years ago
CMakeLists.txt	FilterPolicy consolidation, part 2/2 (#5966 )	5 years ago
CODE_OF_CONDUCT.md	Adopt Contributor Covenant	5 years ago
CONTRIBUTING.md	Add Code of Conduct	7 years ago
COPYING	Add GPLv2 as an alternative license.	8 years ago
DEFAULT_OPTIONS_HISTORY.md	options.delayed_write_rate use the rate of rate_limiter by default.	8 years ago
DUMP_FORMAT.md	First version of rocksdb_dump and rocksdb_undump.	10 years ago
HISTORY.md	Add new persistent 64-bit hash (#5984 )	5 years ago
INSTALL.md	Update the version of the dependencies used by the RocksJava static build (#4761 )	6 years ago
LANGUAGE-BINDINGS.md	LANGUAGE-BINDINGS.md: mention python-rocksdb	6 years ago
LICENSE.Apache	Change RocksDB License	8 years ago
LICENSE.leveldb	Add back the LevelDB license file	8 years ago
Makefile	Include db_stress_tool in rocksdb tools lib (#5950 )	5 years ago
README.md	Replaced some words (#5877 )	5 years ago
ROCKSDB_LITE.md	Fix some typos in comments and docs.	7 years ago
TARGETS	Add clarifying/instructive header to TARGETS and defs.bzl	5 years ago
USERS.md	Add avrio to USERS.md (#5748 )	5 years ago
Vagrantfile	Adding CentOS 7 Vagrantfile & build script	7 years ago
WINDOWS_PORT.md	#5145 , rename port/dirent.h to port/port_dirent.h to avoid compile err when use port dir as header dir output (#5152 )	6 years ago
appveyor.yml	New API to get all merge operands for a Key (#5604 )	5 years ago
defs.bzl	Add clarifying/instructive header to TARGETS and defs.bzl	5 years ago
issue_template.md	Add a template for issues	7 years ago
src.mk	FilterPolicy consolidation, part 2/2 (#5966 )	5 years ago
thirdparty.inc	Fix build jemalloc api (#5470 )	6 years ago

README.md

RocksDB: A Persistent Key-Value Store for Flash and RAM Storage

RocksDB is developed and maintained by Facebook Database Engineering Team. It is built on earlier work on LevelDB by Sanjay Ghemawat (sanjay@google.com) and Jeff Dean (jeff@google.com)

This code is a library that forms the core building block for a fast key-value server, especially suited for storing data on flash drives. It has a Log-Structured-Merge-Database (LSM) design with flexible tradeoffs between Write-Amplification-Factor (WAF), Read-Amplification-Factor (RAF) and Space-Amplification-Factor (SAF). It has multi-threaded compactions, making it especially suitable for storing multiple terabytes of data in a single database.

Start with example usage here: https://github.com/facebook/rocksdb/tree/master/examples

See the github wiki for more explanation.

The public interface is in include/. Callers should not include or rely on the details of any other header files in this package. Those internal APIs may be changed without warning.

Design discussions are conducted in https://www.facebook.com/groups/rocksdb.dev/

License

RocksDB is dual-licensed under both the GPLv2 (found in the COPYING file in the root directory) and Apache 2.0 License (found in the LICENSE.Apache file in the root directory). You may select, at your option, one of the above-listed licenses.