Kratos的使用注意事项
《Kratos的使用注意事项》
一旦在程序中使用Kratos进行Sharding后,sql的编写一定要注意,否则将无法进行路由。sql规则如下所示:
1、暂时不支持分布式事物,因此无法保证事务一致性;
2、不支持多表查询,所有多表查询sql,务必全部打散为单条sql分开查询;
3、不建议使用一些数据库统计函数、Order by语句等;
4、sql的参数第一个必须是路由条件;
5、不支持数据库别名;
6、路由条件必须是整型;
7、采用连续分片时,子表后缀为符号"_"+4位整型,比如“tb_0001”——"tb_1024";
SQL编写注意:
耦合在代码中的sql语句:insert into userinfo(userinfo_id,username) values(?,?),这种写法是不支持的,约定写法必须为:insert into userinfo(userinfo_id,username) values("+ uid +",?),也就是说,第一个参数不允许是占位符,其实第一个参数就是路由条件。
当然,在某些情况下,我们可能不太希望将sql耦合在我们的代码中,这种情况下,我们可以使用类似于Mybatis的做法,将sql定义在配置文件中。Kratos采用的做法很简单,sql定义在properties文件中,采用key-value的方式,key建议定义为持久层的方法名称。sql写法为:addUser=insert into userinfo(uid,name) values(?,?),配置方式,如下所示:
<bean class="com.gxl.kratos.utils.sql.PropertyPlaceholderConfigurer"> <constructor-arg name="path" value="classpath:sql.properties" /> </bean>
除了可以加载classpath下的sql配置文件外,还允许加载文件路径下的sql配置文件。
使用方式如下:
@Resource private PropertyPlaceholderConfigurer property; @Override public void addUser(long routeKey) { final String SQL = property.getSql("addUser", routeKey); kJdbcTemplate.update(SQL); }
上述程序示例中,getSql()方法的第一个参数就是定义在properties中的key,而routeKey就是路由条件。