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.
 
 
 
 
 
 
Changyu Bi f24ef5d6ab Fix BackupEngineTest.ExcludeFiles memory leak (#11066) 1 year ago
.circleci Upgrade CircleCI Windows Build (#10090) 2 years ago
.github/workflows ci: add GitHub token permissions for workflow (#10549) 2 years ago
buckifier Enable BLACK for internal_repo_rocksdb (#10710) 2 years ago
build_tools Print stack traces on frozen tests in CI (#10828) 2 years ago
cache Add a SecondaryCache::InsertSaved() API, use in CacheDumper impl (#10945) 2 years ago
cmake gcc-11 and cmake related cleanup (#9286) 3 years ago
coverage Enable BLACK for internal_repo_rocksdb (#10710) 2 years ago
db Fix typo in flushing stats CF (#11055) 1 year ago
db_stress_tool Prevent db_stress failure when io_uring is disabled (#11045) 2 years ago
docs Bump nokogiri from 1.13.9 to 1.13.10 in /docs (#11024) 2 years ago
env Added placeholders for MADV defines (#10881) 2 years ago
examples Add rocksdb_backup_restore_example to examples/.gitignore (#10825) 2 years ago
file Fix async prefetch heap use after free (#11049) 2 years ago
fuzz Add some missing headers (#10519) 2 years ago
include/rocksdb add c-api for setting option optimize_filters_for_memory (#11044) 1 year ago
java Add missing range conflict check between file ingestion and RefitLevel() (#10988) 1 year ago
logging Observe and warn about misconfigured HyperClockCache (#10965) 2 years ago
memory Fix use of make_unique in Arena::AllocateNewBlock (#11012) 2 years ago
memtable Run clang format against files under example/, memory/ and memtable/ folders (#10893) 2 years ago
microbench Avoid allocations/copies for large `GetMergeOperands()` results (#10458) 2 years ago
monitoring Add an unittest for Periodic compaction conflict with ongoing compaction (#10908) 2 years ago
options Ignore max_compaction_bytes for compaction input that are within output key-range (#10835) 2 years ago
plugin Add initial CMake support to plugin (#9214) 3 years ago
port Fix include of windows.h in mmap.h (#10885) 2 years ago
table Avoid mixing sync and async prefetch (#11050) 2 years ago
test_util ~SleepingBackgroundTask() to wake up the sleeping task (#11036) 2 years ago
third-party Meta-internal folly integration with F14FastMap (#9546) 2 years ago
tools Revert PR 10777 "Fix FIFO causing overlapping seqnos in L0 files due to overla…" (#10999) 2 years ago
trace_replay fix compile warnings (#10976) 2 years ago
util Improve error messages for SST footer and size errors (#11009) 2 years ago
utilities Fix BackupEngineTest.ExcludeFiles memory leak (#11066) 1 year ago
.clang-format A script that automatically reformat affected lines 11 years ago
.gitignore Git ignore .clangd/ (#10817) 2 years ago
.lgtm.yml Create lgtm.yml for LGTM.com C/C++ analysis (#4058) 6 years ago
.watchmanconfig Added .watchmanconfig file to rocksdb repo (#5593) 5 years ago
AUTHORS Update RocksDB Authors File 7 years ago
CMakeLists.txt Add ability to have unit tests for ROCKSDB_PLUGINS (#11052) 1 year 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. 7 years ago
DEFAULT_OPTIONS_HISTORY.md Add Options::DisableExtraChecks, clarify force_consistency_checks (#9363) 2 years ago
DUMP_FORMAT.md First version of rocksdb_dump and rocksdb_undump. 9 years ago
HISTORY.md Add missing range conflict check between file ingestion and RefitLevel() (#10988) 1 year ago
INSTALL.md Update supported VS versions in INSTALL.md (#9823) 2 years ago
LANGUAGE-BINDINGS.md Add grocksdb in Go language bindings (#10498) 2 years ago
LICENSE.Apache Change RocksDB License 7 years ago
LICENSE.leveldb Add back the LevelDB license file 7 years ago
Makefile Add ability to have unit tests for ROCKSDB_PLUGINS (#11052) 1 year ago
PLUGINS.md Add pmem-rocksdb-plugin link in PLUGINs.md (#9934) 2 years ago
README.md Remove Travis CI (#10407) 2 years ago
ROCKSDB_LITE.md Fix remaining uses of "backupable" (#9792) 2 years ago
TARGETS Consider range tombstone in compaction output file cutting (#10802) 2 years ago
USERS.md Add Apache Spark as a user (#10993) 2 years ago
Vagrantfile Adding CentOS 7 Vagrantfile & build script 6 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) 2 years ago
crash_test.mk Allow a custom DB cleanup command to be passed to db_crashtest.py (#10883) 2 years ago
issue_template.md Add Google Group to Issue Template 4 years ago
rocksdb.pc.in build: fix pkg-config file generation (#9953) 2 years ago
src.mk Consider range tombstone in compaction output file cutting (#10802) 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 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.