Tomcat JDBC Pool使用说明

Posted 2020-10-07

Maven依赖

<dependency>
  <groupId>org.apache.tomcat</groupId>
  <artifactId>tomcat-jdbc</artifactId>
  <version>8.5.9</version>
</dependency>

最新版本为9.0，推荐使用8.5.9稳定版

常用配置

连接池配置项很多，下面只列出了推荐配置，项目组可根据自身情况进行增减

<bean id="dataSpource" class="org.apache.tomcat.jdbc.pool.DataSource" destroy-method="close">
    <property name="driverClassName" value="${spring.db.driverClassName}" />
    <property name="url" value="${spring.db.url}" />
    <property name="username" value="${spring.db.username}" />
    <property name="password" value="${spring.db.password}" />
    <!-- 连接器启动时创建的初始连接数。默认为 10 -->
    <property name="initialSize" value="${spring.db.initialSize}" />
    <!-- 最大连接数 默认100 -->
    <property name="maxActive" value="${spring.db.maxActive}" />
    <!-- 最大空闲连接数 默认100 -->
    <property name="maxIdle" value="${spring.db.maxIdle}" />
    <!-- 最小连接数,一般与initialSize一致即可 。默认值取自 initialSize -->
    <property name="minIdle" value="${spring.db.minIdle}" />
    <!--连接池中连接用完时，新的请求的等待时间，超时返回异常，毫秒 默认30000-->
    <property name="maxWait" value="${spring.db.maxWait}" />
    <!-- 连接进入空闲状态时是否经过空闲对象驱逐进程同时进行校验,默认false,依赖validationQuery -->
    <property name="testWhileIdle" value="${spring.db.testWhileIdle}" />
    <!-- 在连接返回给调用者前用于校验连接是否有效的SQL语句，必须为一个SELECT语句，且至少有一行结果 -->
    <property name="validationQuery" value="${spring.db.validationQuery}" />
    <!-- 连接验证的超时时间，单位:秒 -->
    <property name="validationQueryTimeout" value="${spring.db.validationQueryTimeout}" />
    <!-- 检查连接可用性的时间间隔，单位：毫秒 默认30000 -->
    <property name="validationInterval" value="${spring.db.validationInterval}" />
    <!-- 空闲对象驱逐检查时间间隔单位毫秒,默认5000 -->
    <property name="timeBetweenEvictionRunsMillis" value="${spring.db.timeBetweenEvictionRunsMillis}" />
    <!-- 连接被空闲对象驱逐进程驱逐前在池中保持空闲状态的最小时间，单位毫秒,默认60000 -->
    <property name="minEvictableIdleTimeMillis" value="${spring.db.minEvictableIdleTimeMillis}" />
    <!-- 连接池所创建的连接默认自动提交状态,默认为JDBC缺省值 -->
    <property name="defaultAutoCommit" value="${spring.db.defaultAutoCommit}" />
    <!--是否利用 JMX 注册连接池,默认：true-->
    <property name="jmxEnabled" value="${spring.db.jmxEnabled}" />
    <!-- 配置增加查询超时设置(另可配置慢查询自动记录,请查看文档) -->
    <property name="jdbcInterceptors" value="QueryTimeoutInterceptor(queryTimeout=${spring.db.queryTimeout});SlowQueryReport(threshold=${spring.db.threshold})" />
</bean>

推荐参数值：(只用于访问量不是很高的项目，项目组根据情况调整)

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

本文出自 “星技传阅” 博客，请务必保留此出处http://snowtiger.blog.51cto.com/12931578/1966602