rocksdb

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

anand76 afa2420c2b Introduce a new storage specific Env API (#5761 ) Summary: The current Env API encompasses both storage/file operations, as well as OS related operations. Most of the APIs return a Status, which does not have enough metadata about an error, such as whether its retry-able or not, scope (i.e fault domain) of the error etc., that may be required in order to properly handle a storage error. The file APIs also do not provide enough control over the IO SLA, such as timeout, prioritization, hinting about placement and redundancy etc. This PR separates out the file/storage APIs from Env into a new FileSystem class. The APIs are updated to return an IOStatus with metadata about the error, as well as to take an IOOptions structure as input in order to allow more control over the IO. The user can set both ```options.env``` and ```options.file_system``` to specify that RocksDB should use the former for OS related operations and the latter for storage operations. Internally, a ```CompositeEnvWrapper``` has been introduced that inherits from ```Env``` and redirects individual methods to either an ```Env``` implementation or the ```FileSystem``` as appropriate. When options are sanitized during ```DB::Open```, ```options.env``` is replaced with a newly allocated ```CompositeEnvWrapper``` instance if both env and file_system have been specified. This way, the rest of the RocksDB code can continue to function as before. This PR also ports PosixEnv to the new API by splitting it into two - PosixEnv and PosixFileSystem. PosixEnv is defined as a sub-class of CompositeEnvWrapper, and threading/time functions are overridden with Posix specific implementations in order to avoid an extra level of indirection. The ```CompositeEnvWrapper``` translates ```IOStatus``` return code to ```Status```, and sets the severity to ```kSoftError``` if the io_status is retryable. The error handling code in RocksDB can then recover the DB automatically. Pull Request resolved: https://github.com/facebook/rocksdb/pull/5761 Differential Revision: D18868376 Pulled By: anand1976 fbshipit-source-id: 39efe18a162ea746fabac6360ff529baba48486f		5 years ago
buckifier	PosixRandomAccessFile::MultiRead() to use I/O uring if supported (#5881 )	5 years ago
build_tools	Improve instructions to install formatter (#6162 )	5 years ago
cache	Remove key length assertion LRUHandle::CalcTotalCharge (#6115 )	5 years ago
cmake	cmake: do not build tests for Release build and cleanups (#5916 )	5 years ago
coverage	Fix interpreter lines for files with python2-only syntax.	6 years ago
db	Introduce a new storage specific Env API (#5761 )	5 years ago
db_stress_tool	Add useful idioms to Random API (OneInOpt, PercentTrue) (#6154 )	5 years ago
docs	Blog post for write_unprepared (#5711 )	5 years ago
env	Introduce a new storage specific Env API (#5761 )	5 years ago
examples	Add example to show the effect of Get in snapshot isolation (#6059 )	5 years ago
file	Introduce a new storage specific Env API (#5761 )	5 years ago
hdfs	Add copyright headers per FB open-source checkup tool. (#5199 )	6 years ago
include/rocksdb	Introduce a new storage specific Env API (#5761 )	5 years ago
java	Correct java docs of RocksDB options (#6123 )	5 years ago
logging	Introduce a new storage specific Env API (#5761 )	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	Introduce a new storage specific Env API (#5761 )	5 years ago
port	Work around weird unused errors with Mingw (#6075 )	5 years ago
table	Introduce a new storage specific Env API (#5761 )	5 years ago
test_util	Introduce a new storage specific Env API (#5761 )	5 years ago
third-party	Apply formatter to some recent commits (#6138 )	5 years ago
tools	Introduce a new storage specific Env API (#5761 )	5 years ago
trace_replay	Misc hashing updates / upgrades (#5909 )	5 years ago
util	Introduce a new storage specific Env API (#5761 )	5 years ago
utilities	Introduce a new storage specific Env API (#5761 )	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	cmake: do not build tests for Release build and cleanups (#5916 )	5 years ago
.watchmanconfig	Added .watchmanconfig file to rocksdb repo (#5593 )	6 years ago
AUTHORS	Update RocksDB Authors File	7 years ago
CMakeLists.txt	Introduce a new storage specific Env API (#5761 )	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	Introduce a new storage specific Env API (#5761 )	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	Add useful idioms to Random API (OneInOpt, PercentTrue) (#6154 )	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	Introduce a new storage specific Env API (#5761 )	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	Add Visual Studio 2015 to AppVeyor (#5446 )	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	Introduce a new storage specific Env API (#5761 )	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.