A library that provides an embeddable, persistent key-value store for fast storage.
Go to file
Yi Wu c293472908 Add ValueType::kTypeBlobIndex
Summary:
Add kTypeBlobIndex value type, which will be used by blob db only, to insert a (key, blob_offset) KV pair. The purpose is to
1. Make it possible to open existing rocksdb instance as blob db. Existing value will be of kTypeIndex type, while value inserted by blob db will be of kTypeBlobIndex.
2. Make rocksdb able to detect if the db contains value written by blob db, if so return error.
3. Make it possible to have blob db optionally store value in SST file (with kTypeValue type) or as a blob value (with kTypeBlobIndex type).

The root db (DBImpl) basically pretended kTypeBlobIndex are normal value on write. On Get if is_blob is provided, return whether the value read is of kTypeBlobIndex type, or return Status::NotSupported() status if is_blob is not provided. On scan allow_blob flag is pass and if the flag is true, return wether the value is of kTypeBlobIndex type via iter->IsBlob().

Changes on blob db side will be in a separate patch.
Closes https://github.com/facebook/rocksdb/pull/2886

Differential Revision: D5838431

Pulled By: yiwu-arbug

fbshipit-source-id: 3c5306c62bc13bb11abc03422ec5cbcea1203cca
2017-11-02 23:02:50 -07:00
buckifier rocksdb: make buildable on aarch64 2017-08-13 17:13:54 -07:00
build_tools Update RocksDBCommonHelper to use escapeshellarg 2017-08-15 06:56:31 -07:00
cache Not using aligned_alloc with gcc4 + asan 2017-08-29 21:56:02 -07:00
cmake CMake: Add support for CMake packages 2017-08-28 17:14:37 -07:00
coverage Fix /bin/bash shebangs 2017-08-03 15:56:46 -07:00
db Add ValueType::kTypeBlobIndex 2017-11-02 23:02:50 -07:00
docs Minor updates to FlushWAL blog 2017-08-27 07:41:02 -07:00
env Introduce bottom-pri thread pool for large universal compactions 2017-08-03 15:43:29 -07:00
examples Pinnableslice examples and blog post 2017-08-24 12:26:07 -07:00
hdfs Revert "comment out unused parameters" 2017-07-21 18:26:26 -07:00
include/rocksdb Add ValueType::kTypeBlobIndex 2017-11-02 23:02:50 -07:00
java Provide byte[] version of SstFileWriter.merge to reduce GC Stall 2017-08-22 12:55:24 -07:00
memtable Introduce bottom-pri thread pool for large universal compactions 2017-08-03 15:43:29 -07:00
monitoring Scale histogram bucket size by constant factor 2017-08-21 17:10:40 -07:00
options fix some misspellings 2017-08-16 21:57:20 -07:00
port Not using aligned_alloc with gcc4 + asan 2017-08-29 21:56:02 -07:00
table Add ValueType::kTypeBlobIndex 2017-11-02 23:02:50 -07:00
third-party Revert "comment out unused parameters" 2017-07-21 18:26:26 -07:00
tools support disabling checksum in block-based table 2017-08-23 19:40:47 -07:00
util Support prefetch last 512KB with direct I/O in block based file reader 2017-08-11 12:16:45 -07:00
utilities Add ValueType::kTypeBlobIndex 2017-11-02 23:02:50 -07:00
.clang-format A script that automatically reformat affected lines 2014-01-14 12:21:24 -08:00
.gitignore Remove leftover references to phutil_module_cache 2017-08-23 12:12:21 -07:00
.travis.yml Build fewer tests in Travis platform_dependent tests 2017-07-27 17:29:01 -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 Add ValueType::kTypeBlobIndex 2017-11-02 23:02:50 -07:00
CONTRIBUTING.md Remove the licensing description in CONTRIBUTING.md 2017-07-16 15:57:18 -07: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 Bump version to 5.8.1 2017-10-23 22:12:51 -07:00
INSTALL.md add vcpkg as an windows option 2017-07-24 15:12:45 -07:00
LANGUAGE-BINDINGS.md add Erlang to the list of language bindings 2017-08-28 16:43:16 -07:00
LICENSE.Apache Change RocksDB License 2017-07-15 16:11:23 -07:00
LICENSE.leveldb Add back the LevelDB license file 2017-07-16 18:42:18 -07:00
Makefile Add ValueType::kTypeBlobIndex 2017-11-02 23:02:50 -07: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 PessimisticTransaction 2017-08-07 16:12:29 -07:00
TARGETS Add ValueType::kTypeBlobIndex 2017-11-02 23:02:50 -07:00
thirdparty.inc Introduce XPRESS compresssion on Windows. (#1081) 2016-04-19 22:54:24 -07:00
USERS.md Update USERS.md 2017-08-06 12:44:40 -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/