A library that provides an embeddable, persistent key-value store for fast storage.
Go to file
Aaron Gao 7e62c5d67a unbiase readamp bitmap
Summary:
Consider BlockReadAmpBitmap with bytes_per_bit = 32. Suppose bytes [a, b) were used, while bytes [a-32, a)
 and [b+1, b+33) weren't used; more formally, the union of ranges passed to BlockReadAmpBitmap::Mark() contains [a, b) and doesn't intersect with [a-32, a) and [b+1, b+33). Then bits [floor(a/32), ceil(b/32)] will be set, and so the number of useful bytes will be estimated as (ceil(b/32) - floor(a/32)) * 32, which is on average equal to b-a+31.

An extreme example: if we use 1 byte from each block, it'll be counted as 32 bytes from each block.

It's easy to remove this bias by slightly changing the semantics of the bitmap. Currently each bit represents a byte range [i*32, (i+1)*32).

This diff makes each bit represent a single byte: i*32 + X, where X is a random number in [0, 31] generated when bitmap is created. So, e.g., if you read a single byte at random, with probability 31/32 it won't be counted at all, and with probability 1/32 it will be counted as 32 bytes; so, on average it's counted as 1 byte.

*But there is one exception: the last bit will always set with the old way.*

(*) - assuming read_amp_bytes_per_bit = 32.
Closes https://github.com/facebook/rocksdb/pull/2259

Differential Revision: D5035652

Pulled By: lightmark

fbshipit-source-id: bd98b1b9b49fbe61f9e3781d07f624e3cbd92356
2017-05-10 14:06:54 -07:00
arcanist_util Fix arc setting for Facebook internal tools 2017-02-02 13:24:16 -08:00
buckifier internal_repo_rocksdb to build Java and RocksDB LITE 2017-04-12 15:13:41 -07:00
build_tools Rework test running script. 2017-04-05 11:39:20 -07:00
cache Move some files under util/ to separate dirs 2017-04-05 19:09:16 -07:00
cmake/modules CMake: more MinGW fixes 2017-04-06 14:09:13 -07:00
coverage Fix coverage script 2014-11-03 14:53:00 -08:00
db unbiase readamp bitmap 2017-05-10 14:06:54 -07:00
docs Blog post for releasing 5.2.1 2017-03-22 17:54:18 -07:00
env fix memory alignment with logical sector size 2017-05-09 15:16:57 -07:00
examples CMake: more MinGW fixes 2017-04-06 14:09:13 -07:00
hdfs Fix bug in UnScSigned-off-by: xh931076284 <931076284@qq.com> (#1336) 2016-09-14 10:17:34 -07:00
include/rocksdb Bump version to 5.4.2 2017-05-08 17:35:44 +00:00
java change use_direct_writes to use_direct_io_for_flush_and_compaction 2017-04-14 16:19:53 -07:00
memtable Move memtable related files into memtable directory 2017-04-06 14:09:13 -07:00
monitoring Move various string utility functions into string_util 2017-04-06 14:54:12 -07:00
options Respect deprecated flag in table options 2017-04-21 17:52:06 -07:00
port Move some files under util/ to separate dirs 2017-04-05 19:09:16 -07:00
table unbiase readamp bitmap 2017-05-10 14:06:54 -07:00
third-party Fix build with MinGW 2017-03-30 16:54:52 -07:00
tools Add DB:ResetStats() 2017-04-18 17:22:35 -07:00
util do not read next datablock if upperbound is reached 2017-05-10 14:06:33 -07:00
utilities Fix WriteBatchWithIndex address use after scope error 2017-04-28 13:31:19 -07:00
.clang-format A script that automatically reformat affected lines 2014-01-14 12:21:24 -08:00
.deprecated_arcconfig Deprecate .arcconfig 2017-04-07 14:40:30 -07:00
.gitignore Add buckifier script to github repo 2017-04-04 16:24:26 -07:00
.travis.yml Add Travis job to build examples 2017-04-07 10:39:15 -07:00
appveyor.yml Rework test running script. 2017-04-05 11:39:20 -07:00
AUTHORS Add AUTHORS file. Fix #203 2014-09-29 10:52:18 -07:00
CMakeLists.txt FreeBSD only requires WITH_JEMALLOC, not the rest 2017-04-09 11:26:50 -07:00
CONTRIBUTING.md facebook accounts are not required for CLA signers 2014-07-08 05:57:54 -04:00
DEFAULT_OPTIONS_HISTORY.md Change the default of delayed slowdown value to 16MB/s 2017-02-01 20:39:17 -08:00
DUMP_FORMAT.md First version of rocksdb_dump and rocksdb_undump. 2015-06-19 16:24:36 -07:00
HISTORY.md Update HISTORY.md for 5.4.1 2017-05-01 21:49:09 -07:00
INSTALL.md Add a notice on gflags installation in INSTALL.md 2017-04-04 16:39:25 -07:00
LANGUAGE-BINDINGS.md Adding Dlang to the list 2017-02-16 17:24:10 -08:00
LICENSE Updated all copyright headers to the new format. 2016-02-09 15:12:00 -08:00
Makefile Add ROCKSDB_JAVA_NO_COMPRESSION flag 2017-04-11 16:56:59 -07:00
PATENTS Update Patent Grant. 2015-04-13 10:33:43 +01:00
README.md Appveyor badge to show master branch 2016-07-26 13:54:08 -07:00
ROCKSDB_LITE.md Optimistic Transactions 2015-05-29 14:36:35 -07:00
src.mk Refactor compaction picker code 2017-04-06 20:09:34 -07:00
TARGETS sync TARGETS file 2017-04-11 18:17:47 -07:00
thirdparty.inc Introduce XPRESS compresssion on Windows. (#1081) 2016-04-19 22:54:24 -07:00
USERS.md Update USERS.md add user Pika 2017-01-25 10:39:17 -08:00
Vagrantfile Update Vagrant file (test internal phabricator workflow) 2016-10-28 15:39:19 -07:00
WINDOWS_PORT.md Commit both PR and internal code review changes 2015-07-07 16:58:20 -07:00

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

Build Status Build status

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 specially 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/