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