[mysql-proxy]
(必备，默认值即可)管理接口的用户名
• admin-username = user
(必备，默认值即可)管理接口的密码
• admin-password = pwd
(必备，根据实际情况配置)主库的IP和端口
• proxy-backend-addresses = 192.168.0.12:3306
(非必备，根据实际情况配置)从库的IP和端口， @后面的数字代表权重，用来作负载均衡，若省略则默认
为1，可设置多项， 用逗号分隔。如果想让主库也能分担读请求的话，只需要将主库信息加入到下面的配
置项中。
• proxy-read-only-backend-addresses = 192.168.0.13:3306,192.168.0.14:3306
(必备，根据实际情况配置)用户名与其对应的加密过的MySQL密码，密码使用PREFIX/bin目录下的加密程
序encrypt加密，用户名与密码之间用冒号分隔。 主从数据库上需要先创建该用户并设置密码（用户名和密
码在主从数据库上要一致） 。比如用户名为myuser，密码为mypwd，执行./encrypt mypwd结果为
HJBoxfRsjeI=。如果有多个用户用逗号分隔即可。则设置如下行所示：
• pwds = myuser: HJBoxfRsjeI=,myuser2:HJBoxfRsjeI=
（必备，默认值即可)Atlas的运行方式，设为true时为守护进程方式，设为false时为前台方式，一般开发
调试时设为false，线上运行时设为true
• daemon = true
(必备，默认值即可)设置Atlas的运行方式，设为true时Atlas会启动两个进程，一个为monitor，一个为
worker， monitor在worker意外退出后会自动将其重启，设为false时只有worker，没有monitor，一般开发
调试时设为false，线上运行时设为true
• keepalive = true
(必备，根据实际情况配置)工作线程数，推荐设置成系统的CPU核数的2至4倍
• event-threads = 4(必备，默认值即可)日志级别，分为message、 warning、 critical、 error、 debug五个级别
• log-level = message
(必备，默认值即可)日志存放的路径
• log-path = /usr/local/mysql-proxy/log(必备，根据实际情况配置)SQL日志的开关，可设置为OFF、 ON、 REALTIME，OFF代表不记录
SQL日志，ON代表记录SQL日志，该模式下日志刷新是基于缓冲区的，当日志填满缓冲区后，
才将日志信息刷到磁盘。 REALTIME用于调试，代表记录SQL日志且实时写入磁盘，默认为OFF
• sql-log = OFF
(可选项，可不设置）慢日志输出设置。当设置了该参数时，则日志只输出执行时间超过sql-logslow（单位：ms)的日志记录。不设置该参数则输出全部日志。
• sql-log-slow = 10
(可选项，可不设置）关闭不活跃的客户端连接设置。当设置了该参数时，Atlas会主动关闭经过
'wait-timeout'时间后一直未活跃的连接。单位：秒
wait-timeout = 10
(必备，默认值即可)Atlas监听的工作接口IP和端口
proxy-address = 0.0.0.0:1234
(必备，默认值即可)Atlas监听的管理接口IP和端口 admin-address = 0.0.0.0:2345
(可选项，可不设置)默认字符集，若不设置该项，则默认字符集为latin1
charset = utf8
(可选项，可不设置)允许连接Atlas的客户端的IP，可以是精确IP，也可以是IP段，以逗
号分隔，若不设置该项则允许所有IP连接，否则只允许列表中的IP连接
client-ips = 127.0.0.1, 192.168.0.1

proxy-read-only-backend-addresses =192.168.237.130:3308@1,192.168.237.131:3308@1

mysql> select * from students where id=0;
Empty set (0.00 sec)
mysql> select * from students;
ERROR 1146 (42S02): Table 'test.students' doesn't exist
mysql> select * from students where id>2;
ERROR 1146 (42S02): Table 'test.students' doesn't exist

Sharding数据库组

在Atlas中, 将一个组看做是数据存储的单位,一个组由一台master, 零台或者多台slave组成(mysql主从同步需要由用户自己配置). 每个组之间的数据独立, 没有关系, 表的数据的各个部分存储在各个组中.

组内读写分离

与非sharding的方案一样,Atlas sharding也支持组内的读写分离, 也就是说Atlas在命中了某个组之后, 还是会对这个组内的master和slave执行读写分离(读发送到slave, 写发送到master)

[shardrule-0]
table = test.sharding_test #分表名，由数据库+表名组成
type = range #sharding类型：range 或 hash
shard-key = id #sharding 字段
groups = 0:0-999,1:1000-1999 #分片的group，
如果是range类型的sharding，则groups的格式是：group_id:id范围。
如果是hash类型的sharding，则groups的格式是：group_id。例如groups = 0, 1
group. 一个group一般包含一主多从，由master（proxy-backend-addresses）和
slave（proxy-read-only-backend-addresses）组成。 group之间的区别也是通过下
划线后面的数字区分。

DROP TABLE IF EXISTS `sharding_test`;
CREATE TABLE `sharding_test` ( `id` int(11) NOT NULL AUTO_INCREMENT,
`name` char(50) COLLATE utf8_bin NOT NULL,
`age` int(11) DEFAULT NULL,
`birthday` date DEFAULT NULL,
`nickname` char(50) COLLATE utf8_bin DEFAULT NULL,
PRIMARY KEY (`id`) );

[mysql-proxy]
admin-username = user
admin-password = pwd
#Atlas后端连接的MySQL主库的IP和端口，可设置多项，用逗号分隔
proxy-backend-addresses = 192.168.237.128:3308
#proxy-read-only-backend-addresses = 192.168.237.130:3308@1,192.168.237.131:3308@1
daemon = true
keepalive = false
event-threads = 4
log-level = debug
log-path = /usr/local/mysql-proxy/log
sql-log = realtime
proxy-address = 0.0.0.0:1234
admin-address = 0.0.0.0:2345
charset = UTF8
wait-timeout = 3600
pwds = root:S4HJu78/H/6I/aYp2Xdb8Q==
[shardrule-0]
table = test3.sharding_test
type = range
shard-key = id
groups = 0:0-999,1:1000-1999
[group-0]
# master
proxy-backend-addresses=192.168.237.130:3308
# slave
#proxy-read-only-backend-addresses=127.0.0.1:3308
[group-1]
proxy-backend-addresses=192.168.237.131:3308
#proxy-read-only-backend-addresses=127.0.0.1:3310

$ mysql -h127.0.0.1 -P1234 -uroot -pmysqltest -c
mysql> use test3;
Database changed
mysql> insert into sharding_test(id, name, age) values(1, 'test', 0);
Query OK, 1 row affected (0.00 sec)
mysql> insert into sharding_test(id, name, age) values(50, 'test', 0), (999, 'test', 0);
Query OK, 2 rows affected (0.00 sec)

mysql> insert into sharding_test(id, name, age) values(100, 'test', 0), (1500, 'test',
0);
ERROR 1105 (HY000): Proxy Warning - write operation is only allow to one

mysql> insert into sharding_test(id, name, age) values(1000, 'test', 0), (1999,
'test', 0);
Query OK, 2 rows affected (0.00 sec)
mysql> select * from sharding_test;
+------+------+------+----------+----------+
| id | name | age | birthday | nickname |
+------+------+------+----------+----------+
| 1 | test | 0 | NULL | NULL |
| 50 | test | 0 | NULL | NULL |
| 999 | test | 0 | NULL | NULL |
| 1000 | test | 0 | NULL | NULL |
| 1999 | test | 0 | NULL | NULL |mysql> select * from sharding_test where id>50;
+------+------+------+----------+----------+
| id | name | age | birthday | nickname |
+------+------+------+----------+----------+
| 999 | test | 0 | NULL | NULL |
| 1000 | test | 0 | NULL | NULL |
| 1999 | test | 0 | NULL | NULL |#JOIN操作，不支持
mysql> select * from sharding_test a,test.temp b on a.id=b.id;
ERROR 1105 (sqlst): Proxy Warning - Sharing Hit Multi Dbgroup Not Support
SQL#update操作
mysql> update sharding_test set name='test2';
ERROR 1105 (HY000): Proxy Warning - Syntax Forbidden!
mysql> update sharding_test set name='test2' where id<2000;
ERROR 1105 (sqlst): Proxy Warning - write operation is only allow to one
dbgroup!
mysql> update sharding_test set name='test2' where id<999;
Query OK, 2 rows affected (0.01 sec)#delete操作
mysql> delete from sharding_test;
ERROR 1105 (HY000): Proxy Warning - Syntax Forbidden!
mysql> delete from sharding_test where id<2000;
ERROR 1105 (sqlst): Proxy Warning - write operation is only allow to one
dbgroup!
mysql> delete from sharding_test where id>1900;
Query OK, 1 row affected (0.01 sec)