Ardb is a BSD licensed, redis-protocol compatible persistent nosql, it support multiple storage engines as backend like Google's LevelDB, Facebook's RocksDB, OpenLDAP's LMDB, WiredTiger, PerconaFT,Couchbase's ForestDB the default backend is Facebook's RocksDB.
⚠️ This implementation is experimental: This repository is a proof-of-concept of integrating Kreon to Ardb through the RocksDB API. Some features may not work. We have also implemented a direct-to-Kreon plug-in for Ardb in kreon-ardb which should be more stable.
This repository adds Kreon support to Ardb, which is accomplished by intercepting the calls to RocksDB. Kreon provides the same semantics for most of the operations, such as put, get, scans, and deletes, but not for write batches. Kreon does not yet support transactions, so the semantics for write batches are relaxed compared to RocksDB. When commiting a write batch, the issued operations are not atomic.
To compile, use the MakeKreonArdb.sh
script.
Pre-built containers are available. The ardb-kreon
container can be used as a drop-in replacement (it listens on port 6379 by default). The Kreon data file is 20 GB by default and created in /var/ardb/data/
. Its size is configurable via the DATABASE_SIZE
environmental variable. To persist storage accross runs, mount a local folder at /var/ardb
(logs are also placed within).
To run:
mkdir -p ${PWD}/ardb-kreon/data
docker run --rm -p 6379:6379 \
--name ardb-kreon \
-v ${PWD}/ardb-kreon:/var/ardb \
-e "DATABASE_SIZE=20" \
carvicsforth/ardb-kreon:20210407
To run locally:
- change the
data-dir
variable inardb.conf
to point where data will be placed (dir should exist). fallocate -l sizeGB path-to-data-dir/kreon.dat
./deps/kreon/build/tests/mkfs.kreon.single.sh path-to-data-dir/kreon.dat 1 1
src/ardb-server ${PWD}/ardb.conf
Running YCSB workloads:
git clone https://github.com/brianfrankcooper/YCSB.git
cd YCSB
bin/ycsb load|run redis -s -P workloads/workload -p "redis.host=127.0.0.1" -p "redis.port=16379" -p redis.timeout=5000000 -threads thread_num
Rocksdb is the default storage engine, to compile with rocksdb, just type make
to compile server & lib & tests.
To use LMDB or LevelDB or WiredTiger as storage engine, you should set env storage_engine
first.
storage_engine=rocksdb make
storage_engine=leveldb make
storage_engine=lmdb make
storage_engine=wiredtiger make
storage_engine=perconaft make
storage_engine=forestdb make
It should compile to several executables in src
directory, such as ardb-server, ardb-test etc.
- Full redis-protocol compatibility
- Most redis commands supported, and a few new commands.
- Multi storage engines supported
- Multi data structure types supported
- String
- List
- Set
- Sorted Set
- Hash
- Bitmap(String)
- HyperLogLog(String)
- 2D Spatial Index(Sorted Set)
- Stream
- Replication compatible with Redis 2.6/2.8
- Ardb instance work as slave of Redis 2.6/2.8+ instance
- Ardb instance work as master of Redis 2.6/2.8+ instance
- Ardb instance work as slave of Ardb instance
- Auto failover support by redis-sentinel
- Lua Scripting support
- Pub/Sub
- All redis pubsub commands supported
- Transactions
- All redis transaction commands supported
- Backup data online
- Use 'save/bgsave' to backup data
- Use 'import' to import backup data
Since ardb is a full redis-protocol compatible server, you can use most existed redis client to connect it without any problem. Here lists all redis clients. http://www.redis.io/clients
-
Known Issues:
- For Node.js, the recommand client node_redis would try to parse
redis_version:x.y.z
frominfo
command's output, Ardb users should configureredis-compatible-version
in ardb.conf to makesure thatredis_version:x.y.z
exists ininfo
command's output. There is an online redis GUI admin service redsmin build on node_redis, users can test ardb's redis protocol conformance by a visual way.
- For Node.js, the recommand client node_redis would try to parse
Benchmarks were all performed on a four-core Intel(R) Xeon(R) CPU E5520@2.27GHz, with 64 GB of DDR3 RAM, 500 GB of SCSI disk
The benchmark tool is 'redis-benchmark' from redis,50 parallel clients, 10000000 requests, 1000000 random keys each test case.
GCC Version:4.8.3
OS Version: Red Hat Enterprise Linux AS release 4 (Nahant Update 3)
Kernel Version: 2.6.32_1-10-6-0
Redis Version: 2.8.9
Ardb Version: 0.9.1(RocksDB4.3.1), 1 thread(thread-pool-size configured 1) & 16 threads(thread-pool-size configured 16)
RocksDB Options:
write_buffer_size=128M;max_write_buffer_number=16;compression=kSnappyCompression;
block_based_table_factory={block_cache=512M;block_size=4;filter_policy=bloomfilter:10:true};
create_if_missing=true;max_open_files=-1;rate_limiter_bytes_per_sec=50M
Becnhmark data(./redis-benchmark -r 10000000 -n 10000000):
Ardb(1thread) Ardb(16threads) Redis
PING_INLINE 66313.01 79394.7 67294.75
PING_BULK 66844.91 79384.61 65703.02
SET 36238.45 67963.41 64574.45
GET 46979.24 74050.48 65112.64
INCR 35522.72 68102.27 65274.15
LPUSH 24789.29 35788.93 66093.85
LPOP 15812.53 15657 65832.78
SADD 13130.08 12998.49 65573.77
SPOP 200 200 63291.14
LPUSH(for LRANGE) 27693.16 38611.53 65487.89
LRANGE_100 (first 100 elements) 7857.93 33828.36 30797.66
LRANGE_300 (first 300 elements) 3176.16 16369.29 15710.92
LRANGE_500 (first 450 elements) 2156.1 11706.17 11504.83
LRANGE_600 (first 600 elements) 1647.88 9192.53 9094.22
MSET (10 keys) 10217.64 13552.71 37678.97
- Ardb uses 1 thread & 16 threads in this benchmark test, while redis is actually single threaded application. Ardb is a multithreaded applcation, you can start the server with more threads by setting 'thread-pool-size' to 16 or higher to increase the read/write performance.
- There is no any performance improve for SADD/LPUSH/LPOP with 16 threads , because in the test SADD/LPUSH/LPOP always operate on same key, while SADD/LPUSH/LPOP would lock the key until write operation done.
- SPOP have very poor performance in ardb.
- Join the mailing list(Subscribe via email)