A library that provides an embeddable, persistent key-value store for fast storage.
Go to file
Maysam Yabandeh 499ebb3ab5 Optimize for serial commits in 2PC
Summary:
Throughput: 46k tps in our sysbench settings (filling the details later)

The idea is to have the simplest change that gives us a reasonable boost
in 2PC throughput.

Major design changes:
1. The WAL file internal buffer is not flushed after each write. Instead
it is flushed before critical operations (WAL copy via fs) or when
FlushWAL is called by MySQL. Flushing the WAL buffer is also protected
via mutex_.
2. Use two sequence numbers: last seq, and last seq for write. Last seq
is the last visible sequence number for reads. Last seq for write is the
next sequence number that should be used to write to WAL/memtable. This
allows to have a memtable write be in parallel to WAL writes.
3. BatchGroup is not used for writes. This means that we can have
parallel writers which changes a major assumption in the code base. To
accommodate for that i) allow only 1 WriteImpl that intends to write to
memtable via mem_mutex_--which is fine since in 2PC almost all of the memtable writes
come via group commit phase which is serial anyway, ii) make all the
parts in the code base that assumed to be the only writer (via
EnterUnbatched) to also acquire mem_mutex_, iii) stat updates are
protected via a stat_mutex_.

Note: the first commit has the approach figured out but is not clean.
Submitting the PR anyway to get the early feedback on the approach. If
we are ok with the approach I will go ahead with this updates:
0) Rebase with Yi's pipelining changes
1) Currently batching is disabled by default to make sure that it will be
consistent with all unit tests. Will make this optional via a config.
2) A couple of unit tests are disabled. They need to be updated with the
serial commit of 2PC taken into account.
3) Replacing BatchGroup with mem_mutex_ got a bit ugly as it requires
releasing mutex_ beforehand (the same way EnterUnbatched does). This
needs to be cleaned up.
Closes https://github.com/facebook/rocksdb/pull/2345

Differential Revision: D5210732

Pulled By: maysamyabandeh

fbshipit-source-id: 78653bd95a35cd1e831e555e0e57bdfd695355a4
2017-06-24 14:11:29 -07:00
arcanist_util Fix arc setting for Facebook internal tools 2017-02-02 13:24:16 -08:00
buckifier update buckifer/TARGETS 2017-05-24 11:56:57 -07:00
build_tools fixed typo 2017-06-05 11:27:34 -07:00
cache Add GPLv2 as an alternative license. 2017-04-27 18:06:12 -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 Optimize for serial commits in 2PC 2017-06-24 14:11:29 -07:00
docs RocksDB 5.4.5 release blog post 2017-05-26 23:11:56 -07:00
env GNU C library for struct tm has 2 additional fields. 2017-06-13 04:41:35 -07:00
examples CMake: more MinGW fixes 2017-04-06 14:09:13 -07:00
hdfs New API for background work in single thread pool 2017-05-23 11:12:27 -07:00
include/rocksdb Optimize for serial commits in 2PC 2017-06-24 14:11:29 -07:00
java Create a MergeOperator for Cassandra Row Value 2017-06-16 14:27:00 -07:00
memtable WriteBufferManager will not trigger flush if much data is already being flushed 2017-06-21 10:41:37 -07:00
monitoring Sample number of reads per SST file 2017-06-12 07:12:08 -07:00
options Optimize for serial commits in 2PC 2017-06-24 14:11:29 -07:00
port Implement ReopenWritibaleFile on Windows and other fixes 2017-06-20 10:31:13 -07:00
table Optimize for serial commits in 2PC 2017-06-24 14:11:29 -07:00
third-party fixed typo 2017-06-13 16:58:01 -07:00
tools Remove pin_slice option by making it the default 2017-06-15 16:14:08 -07:00
util Optimize for serial commits in 2PC 2017-06-24 14:11:29 -07:00
utilities Optimize for serial commits in 2PC 2017-06-24 14:11:29 -07:00
.clang-format A script that automatically reformat affected lines 2014-01-14 12:21:24 -08:00
.deprecated_arcconfig Update ShipIt to honor TARGETS updates 2017-04-13 16:12:03 -07:00
.gitignore Simple blob file dumper 2017-05-23 10:42:59 -07:00
.travis.yml Force travis to build with clang on MacOS 2017-06-05 15:41:57 -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 Create a MergeOperator for Cassandra Row Value 2017-06-16 14:27:00 -07:00
CONTRIBUTING.md facebook accounts are not required for CLA signers 2014-07-08 05:57:54 -04:00
COPYING Add GPLv2 as an alternative license. 2017-04-27 18:06:12 -07:00
DEFAULT_OPTIONS_HISTORY.md options.delayed_write_rate use the rate of rate_limiter by default. 2017-05-24 09:58:24 -07:00
DUMP_FORMAT.md First version of rocksdb_dump and rocksdb_undump. 2015-06-19 16:24:36 -07:00
HISTORY.md Call RateLimiter for compaction reads 2017-06-13 14:56:46 -07:00
INSTALL.md cross-platform compatibility improvements 2017-05-15 16:15:38 -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 Create a MergeOperator for Cassandra Row Value 2017-06-16 14:27:00 -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 Create a MergeOperator for Cassandra Row Value 2017-06-16 14:27:00 -07:00
TARGETS Create a MergeOperator for Cassandra Row Value 2017-06-16 14:27:00 -07:00
thirdparty.inc Introduce XPRESS compresssion on Windows. (#1081) 2016-04-19 22:54:24 -07:00
USERS.md fixed typo 2017-06-13 16:58:01 -07: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/