Hikari默认配置

发布时间 2023-11-20 09:25:08作者: 辣条丸子

Hikari配置说明

name构造器默认值默认配置validate之后的值描述validate重置
autoCommit TRUE TRUE 自动提交从池中返回的连接
connectionTimeout SECONDS.toMillis(30) = 30000 30000 等待来自池的连接的最大毫秒数 如果小于250毫秒,则被重置回30秒
idleTimeout MINUTES.toMillis(10) = 600000 600000 连接允许在池中闲置的最长时间 如果idleTimeout+1秒>maxLifetime 且 maxLifetime>0,则会被重置为0(代表永远不会退出);如果idleTimeout!=0且小于10秒,则会被重置为10秒
maxLifetime MINUTES.toMillis(30) = 1800000 1800000 池中连接最长生命周期 如果不等于0且小于30秒则会被重置回30分钟
connectionTestQuery null null 如果您的驱动程序支持JDBC4,我们强烈建议您不要设置此属性
minimumIdle -1 10 池中维护的最小空闲连接数 minIdle<0或者minIdle>maxPoolSize,则被重置为maxPoolSize
maximumPoolSize -1 10 池中最大连接数,包括闲置和使用中的连接 如果maxPoolSize小于1,则会被重置。当minIdle<=0被重置为DEFAULT_POOL_SIZE则为10;如果minIdle>0则重置为minIdle的值
metricRegistry null null 该属性允许您指定一个 Codahale / Dropwizard MetricRegistry 的实例,供池使用以记录各种指标
healthCheckRegistry null null 该属性允许您指定池使用的Codahale / Dropwizard HealthCheckRegistry的实例来报告当前健康信息
poolName null HikariPool-1 连接池的用户定义名称,主要出现在日志记录和JMX管理控制台中以识别池和池配置
initializationFailTimeout 1 1 如果池无法成功初始化连接,则此属性控制池是否将 fail fast
isolateInternalQueries FALSE FALSE 是否在其自己的事务中隔离内部池查询,例如连接活动测试
allowPoolSuspension FALSE FALSE 控制池是否可以通过JMX暂停和恢复
readOnly FALSE FALSE 从池中获取的连接是否默认处于只读模式
registerMbeans FALSE FALSE 是否注册JMX管理Bean(MBeans)
catalog driver default null 为支持 catalog 概念的数据库设置默认 catalog
connectionInitSql null null 该属性设置一个SQL语句,在将每个新连接创建后,将其添加到池中之前执行该语句。
driverClassName null null HikariCP将尝试通过仅基于jdbcUrl的DriverManager解析驱动程序,但对于一些较旧的驱动程序,还必须指定driverClassName
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 null null 这个属性允许你直接设置数据源的实例被池包装,而不是让HikariCP通过反射来构造它
schema driver default null 该属性为支持模式概念的数据库设置默认模式
threadFactory null null 此属性允许您设置将用于创建池使用的所有线程的java.util.concurrent.ThreadFactory的实例。
scheduledExecutor null null 此属性允许您设置将用于各种内部计划任务的java.util.concurrent.ScheduledExecutorService实例

 

Hikari配置示例

spring:
  application:
    name: test-cloud
  profiles:
    active: prod
  datasource:
    driver-class-name: com.mysql.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/test?serverTimezone=UTC&characterEncoding=utf-8
    username: root
    password: root
    hikari:
      maximum-pool-size: 12 #最大连接数,小于等于0会被重置为默认值10;大于零小于1会被重置为minimum-idle的值
      connection-timeout: 60000  #连接超时时间:毫秒,小于250毫秒,否则被重置为默认值30秒
      minimum-idle: 10  #最小空闲连接,默认值10,小于0或大于maximum-pool-size,都会重置为maximum-pool-size
      idle-timeout: 500000  #空闲连接超时时间,默认值600000(10分钟),大于等于max-lifetime且max-lifetime>0,会被重置为0;不等于0且小于10秒,会被重置为10秒。
      max-lifetime: 540000  #连接最大存活时间.不等于0且小于30秒,会被重置为默认值30分钟.设置应该比mysql设置的超时时间短
      connection-test-query: SELECT 1    #连接测试查询