springboot配置Hikari连接池方式
作者:闲走天涯
本文介绍了在Springboot中配置Hikari连接池的具体参数和设置,涵盖了autoCommit, connectionTimeout, idleTimeout, maxLifetime, minimumIdle, maximumPoolSize等关键配置项,并提供了它们的默认值、描述和条件下的重置规则
springboot配置Hikari连接池
主要配置
如下:
配置项 | 描述 | 构造器默认值 | 默认配置validate之后的值 | validate重置 |
---|---|---|---|---|
autoCommit | 自动提交从池中返回的连接 | TRUE | TRUE | - |
connectionTimeout | 等待来自池的连接的最大毫秒数 | SECONDS.toMillis(30)=30000 | 30000 | 如果小于250毫秒,则被重置回30秒 |
idleTimeout | 连接允许在池中闲置的最长时间 | MINUTES.toMillis(10)=600000 | 600000 | 如果idleTimeout+1秒>maxLifetime |
maxLifetime | 池中连接最长生命周期 | MINUTES.toMillis(30)=1800000 | 1800000 | 如果不等于0且小于30秒则会被重置回30分钟 |
connectionTestQuery | 如果您的驱动程序支持JDBC4,我们强烈建议您不要设置此属性 | null | null | - |
minimumIdle | 池中维护的最小空闲连接数 | -1 | 10 | minIdle<0或者minIdle>maxPoolSize,则被重置为maxPoolSize |
maximumPoolSize | 池中最大连接数,包括闲置和使用中的连接 | -1 | 10 | 如果maxPoolSize小于1,则会被重置。当minIdle<=0被重置为DEFAULT_POOL_SIZE则为10;如果minIdle>0则重置为minIdle的值 |
metricRegistry | 该属性允许您指定一个 Codahale/Dropwizard MetricRegistry的实例,供池使用以记录各种指标 | null | null | - |
healthCheckRegistry | 该属性允许您指定池使用的Codahale/Dropwizard HealthCheckRegistry的实例来报告当前健康信息 | null | null | - |
poolName | 连接池的用户定义名称,主要出现在日志记录和JMX管理控制台中以识别池和池配置 | null | HikariPool-1 | - |
initializationFailTimeout | 如果池无法成功初始化连接,则此属性控制池是否将 fail fast | 1 | 1 | - |
isolateInternalQueries | 是否在其自己的事务中隔离内部池查询,例如连接活动测试 | FALSE | FALSE | - |
allowPoolSuspension | 控制池是否可以通过JMX暂停和恢复 | FALSE | FALSE | - |
readOnly | 从池中获取的连接是否默认处于只读模式 | FALSE | FALSE | - |
registerMbeans | 是否注册JMX管理Bean(MBeans) | FALSE | FALSE | - |
catalog | 为支持catalog 概念的数据库设置默认 catalog | driver default | null | - |
connectionInitSql | 该属性设置一个SQL语句,在将每个新连接创建后,将其添加到池中之前执行该语句。 | null | null | - |
driverClassName | HikariCP将尝试通过仅基于jdbcUrl的DriverManager解析驱动程序,但对于一些较旧的驱动程序,还必须指定driverClassName | null | null | - |
transactionIsolation | 控制从池返回的连接的默认事务隔离级别 | null | null | - |
validationTimeout | 连接将被测试活动的最大时间量 | SECONDS.toMillis(5)=5000 | 5000 | 如果小于250毫秒,则会被重置回5秒 |
leakDetectionThreshold | 记录消息之前连接可能离开池的时间量,表示可能的连接泄漏 | 0 | 0 | 如果大于0且不是单元测试,则进一步判断:(leakDetectionThreshold<SECONDS.toMillis(2)or(leakDetectionThreshold>maxLifetime&&maxLifetime>0),会被重置为0.即如果要生效则必须>0,而且不能小于2秒,而且当maxLifetime>0时不能大于maxLifetime |
dataSource | 这个属性允许你直接设置数据源的实例被池包装,而不是让HikariCP通过反射来构造它 | null | null | - |
schema | 该属性为支持模式概念的数据库设置默认模式 | driver default | null | - |
threadFactory | 此属性允许您设置将用于创建池使用的所有线程的java.util.concurrent.ThreadFactory的实例。 | null | null | - |
scheduledExecutor | 此属性允许您设置将用于各种内部计划任务的java.util.concurrent.ScheduledExecutorService实例 | null | null | - |
数据库配置
spring.datasource.type=com.zaxxer.hikari.HikariDataSource spring.datasource.driverClassName = com.mysql.jdbc.Driver spring.datasource.url = jdbc:mysql://localhost:3306/ssm?useUnicode=true&characterEncoding=utf-8&useSSL=false spring.datasource.username = root spring.datasource.password = root
Hikari 连接池配置
详细配置请访问:
https://github.com/brettwooldridge/HikariCP
最小空闲连接数量
spring.datasource.hikari.minimum-idle=5
空闲连接存活最大时间,默认600000(10分钟)
spring.datasource.hikari.idle-timeout=180000
连接池最大连接数,默认是10
spring.datasource.hikari.maximum-pool-size=10
此属性控制从池返回的连接的默认自动提交行为,默认值:true
spring.datasource.hikari.auto-commit=true
连接池母子
spring.datasource.hikari.pool-name=MyHikariCP
此属性控制池中连接的最长生命周期,值0表示无限生命周期,默认1800000即30分钟
spring.datasource.hikari.max-lifetime=1800000
数据库连接超时时间,默认30秒,即30000
spring.datasource.hikari.connection-timeout=30000 spring.datasource.hikari.connection-test-query=SELECT 1
总结
以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。