You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Alan Paxton a16e2ff82a Adapt benchmark result script to new fields. (#10120) 2 years ago
.circleci Adapt benchmark result script to new fields. (#10120) 2 years ago
.github/workflows Use released clang-format instead of the one from dev branch (#9646) 3 years ago
buckifier Use optimized folly DistributedMutex in LRUCache when available (#10179) 2 years ago
build_tools Adapt benchmark result script to new fields. (#10120) 2 years ago
cache Replace per-shard chained hash tables with open-addressing scheme (#10194) 2 years ago
cmake gcc-11 and cmake related cleanup (#9286) 3 years ago
coverage Fix commit_prereq and other targets (#9797) 3 years ago
db Expose the initial logger creation error (#10223) 2 years ago
db_stress_tool Add data block hash index to crash test, fix MultiGet issue (#10220) 2 years ago
docs Bump nokogiri from 1.13.4 to 1.13.6 in /docs (#10019) 3 years ago
env Continue to deflake BackupEngineTest.Concurrency (#10228) 2 years ago
examples Add a simple example of backup and restore (#10054) 2 years ago
file Fix race condition with WAL tracking and `FlushWAL(true /* sync */)` (#10185) 2 years ago
fuzz Fix compilation errors and add fuzzers to CircleCI (#9420) 3 years ago
include/rocksdb Update API comment about Options::best_efforts_recovery (#10180) 2 years ago
java Account memory of FileMetaData in global memory limit (#9924) 2 years ago
logging Deflake unit test BackupEngineTest.Concurrency (#10069) 3 years ago
memory Fail DB::Open() if logger cannot be created (#9984) 3 years ago
memtable Rewrite memory-charging feature's option API (#9926) 3 years ago
microbench Fix overflow in ribbon_bench after #10184 (#10195) 2 years ago
monitoring Update stats to help users estimate MultiGet async IO impact (#10182) 2 years ago
options Add basic kRoundRobin compaction policy (#10107) 2 years ago
plugin Add initial CMake support to plugin (#9214) 3 years ago
port Use optimized folly DistributedMutex in LRUCache when available (#10179) 2 years ago
table Add data block hash index to crash test, fix MultiGet issue (#10220) 2 years ago
test_util Fix a bug of not setting enforce_single_del_contracts (#10027) 3 years ago
third-party Meta-internal folly integration with F14FastMap (#9546) 3 years ago
tools Add data block hash index to crash test, fix MultiGet issue (#10220) 2 years ago
trace_replay Use std::numeric_limits<> (#9954) 3 years ago
util Use optimized folly DistributedMutex in LRUCache when available (#10179) 2 years ago
utilities Expose the initial logger creation error (#10223) 2 years ago
.clang-format A script that automatically reformat affected lines 11 years ago
.gitignore Snapshots with user-specified timestamps (#9879) 2 years ago
.lgtm.yml Create lgtm.yml for LGTM.com C/C++ analysis (#4058) 6 years ago
.travis.yml Fix remaining uses of "backupable" (#9792) 3 years ago
.watchmanconfig Added .watchmanconfig file to rocksdb repo (#5593) 5 years ago
AUTHORS Update RocksDB Authors File 7 years ago
CMakeLists.txt Read blob from blob cache if exists when GetBlob() (#10178) 2 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 Add Options::DisableExtraChecks, clarify force_consistency_checks (#9363) 3 years ago
DUMP_FORMAT.md First version of rocksdb_dump and rocksdb_undump. 10 years ago
HISTORY.md Add data block hash index to crash test, fix MultiGet issue (#10220) 2 years ago
INSTALL.md Update supported VS versions in INSTALL.md (#9823) 3 years ago
LANGUAGE-BINDINGS.md Update branch name to "main" in README/LANGUAGE_BINDINGS (#8727) 3 years ago
LICENSE.Apache Change RocksDB License 7 years ago
LICENSE.leveldb Add back the LevelDB license file 7 years ago
Makefile Read blob from blob cache if exists when GetBlob() (#10178) 2 years ago
PLUGINS.md Add pmem-rocksdb-plugin link in PLUGINs.md (#9934) 3 years ago
README.md README: De-list slack channel, list Google group (#9387) 3 years ago
ROCKSDB_LITE.md Fix remaining uses of "backupable" (#9792) 3 years ago
TARGETS Read blob from blob cache if exists when GetBlob() (#10178) 2 years ago
USERS.md Add Solana's RocksDB use case in USERS.md (#9558) 3 years ago
Vagrantfile Adding CentOS 7 Vagrantfile & build script 7 years ago
WINDOWS_PORT.md Update branch name in WINDOWS_PORT.md (#8745) 3 years ago
common.mk Clean up variables for temporary directory (#9961) 3 years ago
crash_test.mk Clean up variables for temporary directory (#9961) 3 years ago
issue_template.md Add Google Group to Issue Template 5 years ago
rocksdb.pc.in build: fix pkg-config file generation (#9953) 3 years ago
src.mk Read blob from blob cache if exists when GetBlob() (#10178) 2 years ago
thirdparty.inc Fix build jemalloc api (#5470) 5 years ago

README.md

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

CircleCI Status TravisCI Status Appveyor Build status PPC64le 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 especially suitable for storing multiple terabytes of data in a single database.

Start with example usage here: https://github.com/facebook/rocksdb/tree/main/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.

Questions and discussions are welcome on the RocksDB Developers Public Facebook group and email list on Google Groups.

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.