JDBC useLocalSessionState

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本地默认值来源于远程服务器(创建连接时获取)。

2.     本地值如何能保证与远程服务器值一致？

一般情况下，驱动可以保证本地值与远程服务器值保持一致。当应用调用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)

3.     实验验证

  本实验通过一个非典型的例子，来对比useLocalSessionState设置的效果。测试使用的jdbc是5.1.37。

useLocalSessionState为false和true的对比。

  

  结果：

c1=80908                                                                                               c1=80908

c1=80909                                                                                               c1=80908

在上述场景下，若useLocalSessionState为false，则事务提交了；而useLocalSessionState为true时，事务没有提交。因此修改参数可能导致业务的逻辑发生变化。

原因分析：

因为通过语句set autocommit=0，jdbc接口本地没有感知，因此JDBC本地的autocommit值没有变化，当useLocalSessionState为true时，再次调用setAutoCommit(ture)设置参数时，本地参数由于之前是true，认为没有变化，不发往远程，远程仍然为非自动提交；而当useLocalSessionState为false时，每次设置都会发往远程，设置生效，远程连接设置为自动提交，从上面的gerneral log可以看到。

 

4.     结论

     设置useLocalSessionState默认值为ture，可能导致业务逻辑含义发生变化。触发的条件是，用户通过语句直接设置自动提交参数，隔离级别参数或只读事务参数。