A high performance NoSQL Database Server powered by Go

Go to file

siddontang 6f39cb17a9 close gracefully wait all resp-client connections closed		2014-11-11 15:21:41 +08:00
Godeps	write batch add data function	2014-11-09 23:10:03 +08:00
client	fix go test race error	2014-11-01 23:28:34 +08:00
cmd	close gracefully	2014-11-11 15:21:41 +08:00
config	adjust default rocksdb config	2014-11-10 17:22:18 +08:00
doc	add SETEX command for KV	2014-10-26 15:15:43 +08:00
etc	adjust default rocksdb config	2014-11-10 17:22:18 +08:00
ledis	close gracefully	2014-11-11 15:21:41 +08:00
lua	use golua directly	2014-09-13 14:11:05 +08:00
rpl	rpl support sync every 1 second	2014-11-11 15:20:26 +08:00
server	close gracefully	2014-11-11 15:21:41 +08:00
store	Merge branch 'rpl-feature' into develop	2014-11-11 09:08:33 +08:00
tools	remove rocksdb_ext	2014-11-05 10:47:49 +08:00
upgrade/ledis-upgrade-ttl	add flag upgrade-ttl	2014-10-29 16:07:58 +08:00
.gitignore	update gitignore	2014-11-05 10:44:57 +08:00
.travis.yml	add travis config	2014-10-31 08:32:55 -04:00
LICENSE	Initial commit	2014-04-29 17:43:09 -07:00
Makefile	remove unnecessary code	2014-11-02 14:21:24 +08:00
README.md	add my Skype id	2014-10-25 14:51:55 +08:00
bootstrap.sh	update, water many time......	2014-11-03 17:53:46 +08:00
dev.sh	remove hyperleveldb	2014-10-16 11:10:19 +08:00

README.md

LedisDB

Ledisdb is a high performance NoSQL like Redis written by go. It supports some data structure like kv, list, hash, zset, bitmap,set.

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

Features

Rich data structure: KV, List, Hash, ZSet, Bitmap, Set.
Stores lots of data, over the memory limit.
Various backend database to use: LevelDB, goleveldb, LMDB, RocksDB, BoltDB, Memory.
Supports transaction using LMDB or BotlDB.
Supports lua scripting.
Supports expiration and ttl.
Supports using redis-cli directly.
Easy to embed in your own Go application.
HTTP API support, json/bson/msgpack output.
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

#install go dependences
./bootstrap.sh

#set build and run environment 
source dev.sh

make
make test

Godep support

LedisDB supports building with godep which can manage LedisDB go dependence automatically.

LevelDB support

Install leveldb and snappy.

LedisDB supplies a simple script to install leveldb and snappy:
```
  sudo sh tools/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.

You can use other LevelDB (like Hyper LevelDB, Basho LevelDB) instead easily, the only thing you may pay attention to is that the header files must be in include/leveldb folder not include/hyperleveldb or other.
Set LEVELDB_DIR and SNAPPY_DIR to the actual install path in dev.sh.
make clean && make

RocksDB support

Install rocksdb(make shared_lib) and snappy first.

LedisDB has not supplied a simple script to install, maybe later.
Set ROCKSDB_DIR and SNAPPY_DIR to the actual install path in dev.sh.
make clean && make

Because RocksDB API may change sometimes, LedisDB may not build successfully. Now LedisDB supports RocksDB version 3.5 or newest master branch.

Choose store database

LedisDB now supports goleveldb, lmdb, leveldb, rocksdb, boltdb, memory. it will use goleveldb as default to store data if you don't 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.conf -db_name=leveldb
```
Flag command set will overwrite config set.

Lua support

Compile and install lua
Set LUA_DIR to the actual path in dev.sh
make clean && make

Configuration

LedisDB uses toml as the configuration format. The basic configuration ./etc/ledis.conf in LedisDB source may help you.

If you don't use a configuration, LedisDB will use the default for you.

Server Example

//set run environment if not
source dev.sh

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

//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"

//use curl
curl http://127.0.0.1:11181/SET/hello/world
→ {"SET":[true,"OK"]}

curl http://127.0.0.1:11181/0/GET/hello?type=json
→ {"GET":"world"}

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 for more.

Todo

See Issues todo

Client

See Clients to find or contribute LedisDB client.

Caveat

You must known that changing store database runtime is very dangerous, LedisDB will not guarantee the data validation if you do it.
Begin a transaction will block any other write operators before you call commit or rollback. Don't use long-time transaction.
pcall and xpcall are not supported in lua, you can see the readme in golua.