1.useLocalSessionState作用
默认情况下,我们的连接串信息没有包含useLocalSessionState参数的设置,这个值默认为false。
这个值的作用是驱动程序是否使用autocommit,read_only和transaction isolation的内部值(jdbc端的本地值)。
如果设置为false,则需要这个判断这三个参数的场景,都需要发语句到远端请求,比如更新语句前,
需要发语句select @@session.tx_read_only确认会话是否只读。
如果设置为true,则只需要取本地值即可。这可以解释为什么有的实例 select @@session.tx_read_only语句很多。
备注:通过扫描jdbc的代码中接口getUseLocalSessionState调用代码,只发现需要@@session.tx_read_only参数的场景。read_only本地默认值,autocommit本地默认值 和 transaction isolation本地默认值来源于远程服务器(创建连接时获取)。
本地值如何能保证与远程服务器值一致?
一般情况下,驱动可以保证本地值与远程服务器值保持一致。当应用调用setAutoCommit, setTransactionIsolation 和 setReadOnly这三个接口设置参数值时,会与远程服务器同步。
具体而言,
当useLocalSessionState为true时,若值与本地值不一致,则发往远程更新;
当useLocalSessionState为false时,无论设置值与本地值是否一致,每次都发往远程更新。这可以解释为什么有些实例set autocommit语句比较多。
但是,若用户设置参数时不通过JDBC接口(比如setAutoCommit),而是执行语句'set autocommit=xxx'设置,那么就会存在本地值与远程不一致的情况,进而可能导致修改参数useLocalSessionState后,业务逻辑发生变化。
相关的设置语句:
set autocommit=0 /*设置会话自动提交模式*/ 对应的JDBC接口: setAutoCommit(false)
set tx_isolation='read-committed' /*设置事务的隔离级别*/ 对应的JDBC接口:setTransactionIsolation('read-committed')
set tx_read_only=0; /*设置只读事务*/ 对应的JDBC接口:setReadOnly(false)
实验验证
非典型的例子,来对比useLocalSessionState设置的效果。测试使用的jdbc是5.1.37。
为false和true的对比。
结果:
c1=80908 c1=80908
c1=80909 c1=80908
为false,则事务提交了;而useLocalSessionState为true时,事务没有提交。因此修改参数可能导致业务的逻辑发生变化。
原因分析:
当useLocalSessionState为true时,再次调用setAutoCommit(ture)设置参数时,本地参数由于之前是true,认为没有变化,不发往远程,远程仍然为非自动提交;而当useLocalSessionState为false时,每次设置都会发往远程,设置生效,远程连接设置为自动提交,从上面的gerneral log可以看到。
结论
设置useLocalSessionState默认值为ture,可能导致业务逻辑含义发生变化。触发的条件是,用户通过语句直接设置自动提交参数,隔离级别参数或只读事务参数。