ssdb

SSDB 是一個 C/C++ 語言開發的高性能 NoSQL 數據庫, 支支持 Key-value, Key-hashmap, Key-zset(sorted set) 等數據結構, 十分適合存儲數億條級別的列表, 排序表等集合數據, 是 Redis 的替代和增強方案。

SSDB 具有和 Redis 相似的 API, 支支持的客戶端包括: PHP, C++, Python, Java, Lua, Ruby,Nodejs, etc。

SSDB 是穩定的, 生產環境使用的, 已經在許多互聯網公司得到廣泛使用, 如 360、TOPGAME。

前言:

本文是將我安裝和測試的步驟記錄下來,總結了 ideawu 的文檔,便於日後使用。

SSDB 的配置文件使用一個 TAB 表示縮進,不可用空格,一個都不行!默認配置參考:ssdb.conf。

SSDB 支持主主、主從的部署,啓動後臺線程後,從庫會毫秒級的同步主庫的數據。

我的 SSDB 安裝包路徑爲:/export/servers/ssdb-master
我的 SSDB 工作目錄爲:/usr/local/ssdb

下載和安裝:
$ wget --no-check-certificate https://github.com/ideawu/ssdb/archive/master.zip
$ unzip master
$ cd ssdb-master
$ make
$ # 將安裝在 /usr/local/ssdb 目錄下 或者指定目錄 make install PREFIX=/home/servers/ssdb
$ sudo make install

#以默認環境配置爲例:
$ cd /usr/local/ssdb

# 啓動主庫,也可以自定義配置文件,啓動多實例
$ ./ssdb-server ssdb.conf

# 啓動、停止、重新啓動
# $ ./ssdb-ins.sh start/stop/restart ssdb.conf

# 啓動爲後臺進程
$ ./ssdb-server -d ssdb.conf

# 啓動 ssdb 命令行,在安裝包路徑下,8889 爲主庫的端口
$ /export/servers/ssdb-master/tools/ssdb-cli -p 8889
# 連接遠程 SSDB 服務的命令行
# $ /export/servers/ssdb-master/tools/ssdb-cli -h 192.168.1.1 -p 8889

# 停止 ssdb-server,默認都需要手動停止 SSDB 服務
$ kill `cat ./var/ssdb.pid`
# 或者先找到當前 SSDB 進程的 pid,然後絕殺
# $ ps -ef|grep 'ssdb'
# $ kill -9 6912


SSDB 安裝

SSDB 安裝示例圖

安裝包介紹:

SSDB 工作默認目錄:/usr/local/ssdb
配置文件:/usr/local/ssdb/ssdb.conf
數據及實例配置:/usr/local/ssdb/var/
開機啓動命令:/etc/init.d/ssdb.sh
開機自啓動權限:chmod ugo+x /etc/init.d/ssdb.sh
默認端口:8888

SSDB 啓動腳本(隨操作系統自啓動):

到目前爲止, 你需要手動管理 ssdb-server 進程, 如果你希望在操作系統啓動和停止時自動地管理, 請按下面的說明進行。

假設你已經安裝 SSDB 在默認的 /usr/local/ssdb 目錄, 把安裝包下的 tools/ssdb.sh 腳本放到 /etc/init.d 目錄下。

將 /etc/init.d/ssdb.sh 中的 /data/ssdb_data/test/ssdb.conf 修改爲你的 SSDB 配置文件的路徑,如果你有多個 SSDB 實例, 那麼把它們寫在一行, 用空格來分隔:
# each config file for one instance
configs=/data/ssdb_data/test/ssdb.conf /data/ssdb_data/demo/ssdb.conf


主主、主從配置:

當前實例的服務端口配置
server:
 #ip: 127.0.0.1
 port: 8888
 # bind to public ip
 ip: 0.0.0.0
 # format: allow|deny: all|ip_prefix
 # multiple allows or denys is supported
 #deny: all
 #allow: 127.0.0.1
 #allow: 192.168


主從
 下面以主庫 ip :192.168.1.1 爲例介紹
#server 1(主) 
replication:
 slaveof:


#server 2(從)
replication:
 slaveof:
  id: svc_1
  # sync|mirror, default is sync
  type: sync
  ip: 192.168.1.1
  port: 8888


主-主(雙主)
 下面以主庫 ip :192.168.1.1/192.168.1.2 爲例介紹
#server 1
replication:
 slaveof:
  id: svc_2
  # sync|mirror, default is sync
  type: mirror
  ip: 192.168.1.1
  port: 8889


#server 2
replication:
 slaveof:
  id: svc_1
  # sync|mirror, default is sync
  type: mirror
  ip: 192.168.1.2
  port: 8888


注意:

1、如果出現宕機、掉電、kernel panic 等系統故障,需要手動刪除 SSDB 的PID文件,如果將 tools/ssdb.sh 放到 /etc/init.d/ 重啓後自動刪除pid;
2、默認配置的日誌文件按體積分隔,需要編寫自己的 crontab 進行日誌壓縮和定期清理;
3、配置的 ip 最好是 0.0.0.0,外部可以訪問,如果是 127.0.0.1 只能本機訪問。

使用 SSDB 命令行客戶端(ssdb-cli)

SSDB 的命令行行客戶端 ssdb-cli 可用用於日日常管理, 包括查看 SSDB 的運行行狀態(info), 還能做一些 API 沒有的操作, 如清空整個數據庫。

1、運行行 ssdb-cli
# 連接到 127.0.0.1:8888,
$ /usr/local/ssdb/ssdb-cli -h 127.0.0.1 -p 8888


你可以輸入入字母母 h, 然後按回車查看幫助信息。

2、進行行 KV 操作
ssdb 127.0.0.1:8888>get key
ssdb 127.0.0.1:8888>set key 1
ssdb 127.0.0.1:8888>del key


3、進行行 hashmap 操作
ssdb 127.0.0.1:8888> hsize h
ssdb 127.0.0.1:8888> hset h k1 vb
ssdb 127.0.0.1:8888> hset h k2 va
ssdb 127.0.0.1:8888> hset h k3 vc
ssdb 127.0.0.1:8888> hscan h "" "" 10
ssdb 127.0.0.1:8888> hclear h


4、進行行 zset 操作
ssdb 127.0.0.1:8888> zsize z
ssdb 127.0.0.1:8888> zset z k1 2
ssdb 127.0.0.1:8888> zset z k2 0
ssdb 127.0.0.1:8888> zset z k3 1
ssdb 127.0.0.1:8888> zscan z "" "" "" 10
ssdb 127.0.0.1:8888> zclear z


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章