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就是路由条件。 

相关推荐