Tomcat JDBC Pool使用说明

huhahapz

Maven依赖

  org.apache.tomcat
  tomcat-jdbc
  8.5.9
最新版本为9.0，推荐使用8.5.9稳定版
常用配置
连接池配置项很多，下面只列出了推荐配置，项目组可根据自身情况进行增减

   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
推荐参数值：(只用于访问量不是很高的项目，项目组根据情况调整)
spring.db.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
spring.db.url=jdbc:sqlserver://10.8.1.112:1433;DatabaseName=xxx;sendStringParametersAsUnicode=false
spring.db.username=test
spring.db.password=test
spring.db.initialSize=5
spring.db.maxActive=50
spring.db.maxIdle=30
spring.db.minIdle=5
spring.db.maxWait=10000
spring.db.testWhileIdle=true
spring.db.validationQuery=select 1
spring.db.validationQueryTimeout=1
spring.db.validationInterval=30000
spring.db.timeBetweenEvictionRunsMillis=10000
spring.db.minEvictableIdleTimeMillis=60000
spring.db.defaultAutoCommit=true
spring.db.jmxEnabled=true
#慢查询超时阈值,单位秒
spring.db.queryTimeout=5
#慢查询语句自动记录阈值，注意单位毫秒
spring.db.threshold=3000参数说明
属性名描述默认值driverClassName用户名-url密码-username建立连接的url-password数据库驱动的完整类名-initialSize连接器启动时创建的初始连接数10maxActive最大连接数，通常为常规访问的最大数据库并发数，建议根据后期jmx监控逐渐调优100maxIdle最大空闲连接数，比较难把握的一个参数，许多连接池也已经移除了此属性(如Druid)，访问峰值比较集中的系统如考勤可以设置小一点节省大部分时段的连接资源，过小也可能导致连接频繁创建关闭也会影响性能，建议一般系统不低于maxActive的50%100minIdle最小连接数,一般与initialSize一致即可10maxWait连接池中连接用完时，新的请求的等待时间，超时返回异常，单位毫秒默认30000testWhileIdle连接进入空闲状态时是否经过空闲对象驱逐进程同时进行校验，推荐的校验方法，依赖validationQueryfalsevalidationQuery在连接返回给调用者前用于校验连接是否有效的SQL语句，必须为一个SELECT语句，且至少有一行结果-validationQueryTimeout连接验证的超时时间，单位秒，注：池本身并不会让查询超时，完全是依靠JDBC驱动来强制查询超时-validationIntervalTomcatJDBC特有属性，检查连接可用性的时间间隔，防止testOnBorrow和testOnReturn为true时检查过于频繁，单位毫秒30000timeBetweenEvictionRunsMillis空闲对象驱逐检查时间间隔，单位毫秒5000minEvictableIdleTimeMillis连接被空闲对象驱逐进程驱逐前在池中保持空闲状态的最小时间，单位毫秒60000defaultAutoCommit连接池所创建的连接默认自动提交状态（JDBC缺省值意思是默认不会调用setAutoCommit方法）JDBC缺省值jmxEnabled是否利用 JMX 注册连接池truejdbcInterceptorsTomcatJDBC特有属性， QueryTimeoutInterceptor（查询超时拦截器，属性queryTimeout，单位秒，默认1秒），SlowQueryReport（慢查询记录，属性threshold超时纪录阈值单位毫秒，默认1000），多个用拦截器用;分隔，示例：QueryTimeoutInterceptor(queryTimeout=5);SlowQueryReport(threshold=3000)注：当新语句创建时，自动调用Statement.setQueryTimeout(seconds)。池本身并不会让查询超时，完全是依靠JDBC驱动来强制查询超时，更详细的信息请查看官方文档-testOnBorrow连接被调用时是否校验，依赖validationQuery，对性能有一定影响，不推荐使用falsetestOnReturn连接返回到池中是时是否校验,依赖validationQuery，对性能有一定影响，不推荐使用falseremoveAbandoned是否清除已经超过 removeAbandonedTimeout 设置的连接，可用于排查一些事务未提交的问题(正式环境谨慎使用,对性能有一定影响),不推荐使用，可用QueryTimeOut拦截器替代falseremoveAbandonedTimeout清除无效连接的时间，单位秒 与removeAbandoned联合使用60defaultReadOnly连接池创建的连接是否是否为只读，需要说明的是设置了true只是告诉数据库连接是只读，便于数据库做一些优化(例如不安排数据库锁)，并非不能执行更新操作，只是对数据的一致性的保护并不强而已（这跟spring的只读事务类似）JDBC缺省