A high performance NoSQL Database Server powered by Go
Go to file
holys d1362552c0 add more error input params tests 2014-07-28 01:58:55 +08:00
client add client hiredis 2014-07-23 17:09:16 +00:00
cmd add rocksdb support 2014-07-26 18:39:54 +08:00
doc Update command documents, 2014-07-16 16:57:44 +08:00
etc update daemon config 2014-07-26 18:42:31 +08:00
ledis Merge branch 'storage-feature' into develop 2014-07-26 18:43:23 +08:00
server add more error input params tests 2014-07-28 01:58:55 +08:00
store add rocksdb support 2014-07-26 18:39:54 +08:00
.gitignore update make 2014-07-26 09:22:09 +08:00
LICENSE Initial commit 2014-04-29 17:43:09 -07:00
Makefile update build 2014-07-27 07:01:01 +08:00
README.md update build 2014-07-27 07:01:01 +08:00
benchmark.md update document 2014-07-02 14:18:28 +08:00
bootstrap.sh update make 2014-07-26 09:22:09 +08:00
build_leveldb.sh refactor, support use embedded ledisdb 2014-05-15 14:19:48 +08:00
dev.sh add rocksdb support 2014-07-26 18:39:54 +08:00

README.md

LedisDB

Ledisdb is a high performance NoSQL like Redis written by go. It supports some advanced data structure like kv, list, hash and zset, and may be alternative for Redis.

LedisDB now supports multi database as backend to store data, you can test and choose the proper one for you.

Features

  • Rich advanced data structure: KV, List, Hash, ZSet, Bit.
  • Stores lots of data, over the memory limit.
  • Various backend database to use: LevelDB, goleveldb, LMDB.
  • Supports expiration and ttl.
  • Redis clients, like redis-cli, are supported directly.
  • Multi client API supports, including Golang, Python, Lua(Openresty).
  • Easy to embed in Golang application.
  • Replication to guarantee data safe.
  • Supplies tools to load, dump, repair database.

Build and Install

Create a workspace and checkout ledisdb source

mkdir $WORKSPACE
cd $WORKSPACE
git clone git@github.com:siddontang/ledisdb.git src/github.com/siddontang/ledisdb

cd src/github.com/siddontang/ledisdb

source dev.sh && make

LevelDB support

  • Install leveldb and snappy.

    LedisDB supplies a simple script to install leveldb and snappy:

      sh build_leveldb.sh
    

    It will default install leveldb at /usr/local/leveldb and snappy at /usr/local/snappy.

    LedisDB use the modified LevelDB for better performance, see here.

  • Set LEVELDB_DIR and SNAPPY_DIR to the actual install path in dev.sh.

  • source dev.sh && make

RocksDB support

  • Install rocksdb and snappy first.

    LedisDB has not supplied a simple script to install, maybe it will later.

  • Set ROCKSDB_DIR and SNAPPY_DIR to the actual install path in dev.sh.

  • source dev.sh && make

Choose store database

LedisDB now supports goleveldb, lmdb, leveldb, rocksdb, it will choose goleveldb as default to store data if you not set.

Choosing a store database to use is very simple, you have two ways:

  • Set in server config file

      "db" : {
          "name" : "leveldb"
      }
    
  • Set in command flag

      ledis-server -config=/etc/ledis.json -db_name=leveldb
    

    Flag command set will overwrite config set.

Caveat

You must known that changing store database runtime is very dangerous, LedisDB will not guarantee the data validation if you do it.

Server Example

ledis-server -config=/etc/ledis.json

//another shell
ledis-cli -p 6380

ledis 127.0.0.1:6380> set a 1
OK
ledis 127.0.0.1:6380> get a
"1"

Package Example

import "github.com/siddontang/ledisdb/ledis"
l, _ := ledis.Open(cfg)
db, _ := l.Select(0)

db.Set(key, value)

db.Get(key)

Replication Example

Set slaveof in config or dynamiclly

ledis-cli -p 6381 

ledis 127.0.0.1:6381> slaveof 127.0.0.1 6380
OK

Benchmark

See benchmark.md for more.

Todo

See Issues todo

Thanks

Gmail: cenqichao@gmail.com

Gmail: chendahui007@gmail.com

Gmail: cppgohan@gmail.com

Gmail: tiaotiaoyly@gmail.com

Gmail: wyk4true@gmail.com

Feedback

Gmail: siddontang@gmail.com