ssdbproxy

ssdb sharding proxy service by go lang.

Version

version: 0.0.7

Futures

support functions:
	auth 
	set
	get
	del
	incr
	exists
	keys
	rkeys
	scan
	rscan
	multi_set
	multi_get
	multi_del
	hset
	hget
	hdel
	hincr
	hexists
	hsize
	hlist
	hrlist
	hkeys
	hgetall
	hscan
	hrscan
	hclear
	multi_hset
	multi_hget
	multi_hdel
	zip 

##Support gzip transfer:

if you send command "zip" with args "1" to proxy server, proxy server will retrun base64 encode gzip string

golang example code:

https://github.com/matishsiao/gossdb

Configuration

use json format to configuration proxy setting.

Configuration Example

	{
	  "debug":true,
	  "host":"127.0.0.1", //Proxy listen host
	  "port":4001,// Proxy listen port
	  "sync":false,//show db mirror status
	  "password":"", //Proxy password
	  "timeout":120, // client idle timeout
	  "limit":10, //each ssdb connection limit
	  "nodelist":[ //Sharding nodes
	    {
	      "id":"current", 
	      "host":"127.0.0.1",
	      "port":4002,
	      "password":"ssdbpassword",
	      "mode":"main",//current db
	      "weight":100
	    },
	    {
	      "id":"db2",
	      "host":"127.0.0.1",
	      "port":4003,
	      "password":"ssdbpassword",
	      "mode":"mirror",//all proxy set or delete command will auto sync up to this proxy server
	      "weight":100
	    },
	    {
	      "id":"db3",
	      "host":"127.0.0.1",
	      "port":4004,
	      "password":"ssdbpassword",
	      "mode":"queries",//queries slave db
	      "weight":100
	    }
	    ]
	}

SSDBProxy Configuration

Config Fields	Description
debug	debug mode:true / false
host	proxy listen host
port	proxy listen port
sync	proxy sync debug mode: true / false
password	if you use auth params,you can use it to control connection
timeout	client connection idle timeout (sec)
limit	Proxy connect to SSDB server connection pool limit (Per one SSDB or Proxy)
nodelist	Default mode equal "main" is current db,so we will read/write in this node first.

Node Configuration

Node Fields	Description
id	node id for human watch
host	ssdb host
port	ssdb or proxy port
password	ssdb password or proxy server password
mode	db mode: main / mirror / queries / sync
weight	queries weight (no use)

Node Mode Configuration

Mode	Description
main	default main SSDB Server ,this server only one
mirror	when Proxy receive need mirror operation command, it will send to all mirror SSDB Proxys sync up with mirror command
queries	local SSDB queries node
sync	when Proxy receive need mirror operation command, it will send to all origin SSDB server with origin command

#How to build

 go get github.com/matishsiao/ssdbproxy/
 cd $GOPATH/github.com/matishsiao/ssdbproxy
 go build

#see more information? http://matishsiao.blogspot.tw/2015/09/ssdb-sharding-proxy.html