1,安装go语言环境,(Go版本要求1.3以上)
wget https://storage.googleapis.com/golang/go1.6.3.linux-amd64.tar.gz
tar -C /usr/local/ -xzf go1.6.3.linux-amd64.tar.gz
配置环境变量,在/etc/profile中加入下列设置:
export GOROOT=/usr/local/go
export PATH=$GOROOT/bin:$PATH
创建工作区/usr/local/go/work(自己指定目录),在/etc/profile中加入下列设置:
export GOPATH=/usr/local/go/work
2,安装git
yum install -y git
3,安装kingshard
git clone https://github.com/flike/kingshard.git src/github.com/flike/kingshard
cd src/github.com/flike/kingshard
source ./dev.sh
make
4, 设置配置文件
etc目录下面有两个配置文件模板,对应shard和非shard版本,可根据需求自由选择。
cat unshard.yaml
addr : 0.0.0.0:9696
user : kingshard
password : kingshard
log_level : warn
nodes :
-
name : node1
max_conns_limit : 32
user : kingshard
password : kingshard
master : 172.31.18.104:3306
slave : 172.31.18.105:3306@1,172.31.38.150:3306@1
down_after_noalive : 32
schema :
db : kingshard
nodes: [node1]
default: node1
shard:
-
5,按照配置文件里面的设置对用户授权
GRANT ALL PRIVILEGES ON *.* TO 'kingshard'@'172.31.38.151' IDENTIFIED BY 'kingshard';
7. 运行kingshard。
./bin/kingshard -config=etc/unshard.yaml
ps -ef | grep kingshard
root 6942 26963 0 02:44 pts/2 00:00:00 ./bin/kingshard -config=etc/unshard.yaml
8. 配置文件参数说明
# kingshard的地址和端口
addr : 0.0.0.0:9696
# 连接kingshard的用户名和密码
user : kingshard
password : kingshard
# log级别,[debug|info|warn|error],默认是error
log_level : debug
# 打开SQL日志,设置为on;关闭SQL日志,设置为off
log_sql : on
#如果设置了该项,则只输出SQL执行时间超过slow_log_time(单位毫秒)的SQL日志,不设置则输出全部SQL日志
slow_log_time : 100
#日志文件路径,如果不配置则会输出到终端。
log_path : /Users/flike/log
# sql黑名单文件路径
# 所有在该文件中的sql都会被kingshard拒绝转发
#blacklist_sql_file: /Users/flike/blacklist
# 只允许下面的IP列表连接kingshard,如果不配置则对连接kingshard的IP不做限制。
allow_ips: 127.0.0.1
# kingshard使用的字符集,如果不设置该选项,则kingshard使用utf8作为默认字符集
#proxy_charset: utf8mb4
# 一个node节点表示mysql集群的一个数据分片,包括一主多从(可以不配置从库)
nodes :
-
#node节点名字
name : node1
# 连接池中最大空闲连接数,也就是最多与后端DB建立max_conns_limit个连接
max_conns_limit : 16
# kingshard连接该node中mysql的用户名和密码,master和slave的用户名和密码必须一致
user : kingshard
password : kingshard
# master的地址和端口
master : 127.0.0.1:3306
# slave的地址、端口和读权重,@后面的表示该slave的读权重。可不配置slave
#slave : 192.168.0.12@2,192.168.0.13@3
#kingshard在300秒内都连接不上mysql,kingshard则会下线该mysql
down_after_noalive : 300
-
name : node2
max_conns_limit : 16
user : kingshard
password : kingshard
master : 192.168.59.103:3307
slave :
down_after_noalive: 100
# 分表规则
schema :
#分表使用的db,所有的分表必须都在这个db中,连接ks时如果没有指定database默认使用该db。
db : kingshard
#分表分布的node名字
nodes: [node1,node2]
#所有未分表的SQL,都会发往默认node。
default: node1
shard:
-
#分表名字
table: test_shard_hash
#分表字段
key: id
#分表分布的node
nodes: [node1, node2]
#分表类型
type: hash
#子表个数分布,表示node1有4个子表,
#node2有4个子表。
locations: [4,4]
-
#分表名字
table: test_shard_range
#分表字段
key: id
#分表类型
type: range
#分表分布的node
nodes: [node1, node2]
#子表个数分布,表示node1有4个子表,
#node2有4个子表。
locations: [4,4]
#表示每个子表包含的最大记录数,也就是说每
#个子表最多包好10000条记录。即子表1对应的id为[0,10000),子表2[10000,20000)....
table_row_limit: 10000
kingshard采用的是yaml方式解析配置文件,需要注意的是yaml配置文件不允许出现tab键,且冒号后面需要跟一个空格。配置文件编写完成后,可以在yaml lint网站验证是否有格式错误
参考:https://github.com/flike/kingshard/blob/master/doc/KingDoc/kingshard_install_document.md