HikariConfig配置详解
SpringBoot 2.0 開始推 HikariCP ,將默認(rèn)的數(shù)據(jù)庫連接池從 tomcat jdbc pool 改為了 hikari , HikariCP 在性能和并發(fā)方面確實(shí)表現(xiàn)不俗(號稱最快的連接池)。
如果你使用 spring-boot-starter-jdbc 或 spring-boot-starter-data-jpa ,會自動添加對 HikariCP 的依賴,也就是說此時(shí)使用 HikariCP 。當(dāng)然你也可以強(qiáng)制使用其它的連接池技術(shù),可以通過在 application.properties 或 application.yml 中配置 spring.datasource.type 指定。
基本配置
已經(jīng)默認(rèn)使用 HikariCP,所以只需要在 yaml 中添加數(shù)據(jù)庫配置即可:
url: jdbc:mysql://localhost:3306?useSSL=false
username: root
password: 1234
HikariCP 默認(rèn)配置
主要參數(shù)是在 com.zaxxer.hikari.HikariConfig 中初始化的,部分參數(shù)是在 com.zaxxer.hikari.pool.PoolBase 中初始化的。
name?? ?描述?? ?構(gòu)造器默認(rèn)值?? ?默認(rèn)配置validate之后的值?? ?validate重置
autoCommit?? ?自動提交從池中返回的連接?? ?true?? ?true?? ?-
connectionTimeout?? ?等待來自池的連接的最大毫秒數(shù)?? ?SECONDS.toMillis(30) = 30000?? ?30000?? ?如果小于250毫秒,則被重置回30秒
idleTimeout?? ?連接允許在池中閑置的最長時(shí)間?? ?MINUTES.toMillis(10) = 600000?? ?600000?? ?如果idleTimeout+1秒>maxLifetime 且 maxLifetime>0,則會被重置為0(代表永遠(yuǎn)不會退出);如果idleTimeout!=0且小于10秒,則會被重置為10秒
maxLifetime?? ?池中連接最長生命周期?? ?MINUTES.toMillis(30) = 1800000?? ?1800000?? ?如果不等于0且小于30秒則會被重置回30分鐘
connectionTestQuery?? ?如果您的驅(qū)動程序支持JDBC4,我們強(qiáng)烈建議您不要設(shè)置此屬性?? ?null?? ?null?? ?-
minimumIdle?? ?池中維護(hù)的最小空閑連接數(shù)?? ?-1?? ?10?? ?minIdle<0或者minIdle>maxPoolSize,則被重置為maxPoolSize
maximumPoolSize?? ?池中最大連接數(shù),包括閑置和使用中的連接?? ?-1?? ?10?? ?如果maxPoolSize小于1,則會被重置。當(dāng)minIdle<=0被重置為DEFAULT_POOL_SIZE則為10;如果minIdle>0則重置為minIdle的值
metricRegistry?? ?該屬性允許您指定一個(gè) Codahale / Dropwizard MetricRegistry 的實(shí)例,供池使用以記錄各種指標(biāo)?? ?null?? ?null?? ?-
healthCheckRegistry?? ?該屬性允許您指定池使用的Codahale / Dropwizard HealthCheckRegistry的實(shí)例來報(bào)告當(dāng)前健康信息?? ?null?? ?null?? ?-
poolName?? ?連接池的用戶定義名稱,主要出現(xiàn)在日志記錄和JMX管理控制臺中以識別池和池配置?? ?null?? ?HikariPool-1?? ?-
initializationFailTimeout?? ?如果池?zé)o法成功初始化連接,則此屬性控制池是否將 fail fast?? ?1?? ?1?? ?-
isolateInternalQueries?? ?是否在其自己的事務(wù)中隔離內(nèi)部池查詢,例如連接活動測試?? ?false?? ?false?? ?-
allowPoolSuspension?? ?控制池是否可以通過JMX暫停和恢復(fù)?? ?false?? ?false?? ?-
readOnly?? ?從池中獲取的連接是否默認(rèn)處于只讀模式?? ?false?? ?false?? ?-
registerMbeans?? ?是否注冊JMX管理Bean(MBeans)?? ?false?? ?false?? ?-
catalog?? ?為支持 catalog 概念的數(shù)據(jù)庫設(shè)置默認(rèn) catalog?? ?driver default?? ?null?? ?-
connectionInitSql?? ?該屬性設(shè)置一個(gè)SQL語句,在將每個(gè)新連接創(chuàng)建后,將其添加到池中之前執(zhí)行該語句。?? ?null?? ?null?? ?-
driverClassName?? ?HikariCP將嘗試通過僅基于jdbcUrl的DriverManager解析驅(qū)動程序,但對于一些較舊的驅(qū)動程序,還必須指定driverClassName?? ?null?? ?null?? ?-
transactionIsolation?? ?控制從池返回的連接的默認(rèn)事務(wù)隔離級別?? ?null?? ?null?? ?-
validationTimeout?? ?連接將被測試活動的最大時(shí)間量?? ?SECONDS.toMillis(5) = 5000?? ?5000?? ?如果小于250毫秒,則會被重置回5秒
leakDetectionThreshold?? ?記錄消息之前連接可能離開池的時(shí)間量,表示可能的連接泄漏?? ?0?? ?0?? ?如果大于0且不是單元測試,則進(jìn)一步判斷:(leakDetectionThreshold < SECONDS.toMillis(2) or (leakDetectionThreshold > maxLifetime && maxLifetime > 0),會被重置為0 . 即如果要生效則必須>0,而且不能小于2秒,而且當(dāng)maxLifetime > 0時(shí)不能大于maxLifetime
dataSource?? ?這個(gè)屬性允許你直接設(shè)置數(shù)據(jù)源的實(shí)例被池包裝,而不是讓HikariCP通過反射來構(gòu)造它?? ?null?? ?null?? ?-
schema?? ?該屬性為支持模式概念的數(shù)據(jù)庫設(shè)置默認(rèn)模式?? ?driver default?? ?null?? ?-
threadFactory?? ?此屬性允許您設(shè)置將用于創(chuàng)建池使用的所有線程的java.util.concurrent.ThreadFactory的實(shí)例。?? ?null?? ?null?? ?-
scheduledExecutor?? ?此屬性允許您設(shè)置將用于各種內(nèi)部計(jì)劃任務(wù)的java.util.concurrent.ScheduledExecutorService實(shí)例?? ?null?? ?null?? ?-
HikariCP 配置多數(shù)據(jù)源
application.yml :
hikari:
? ? primary:
? ? ? ? jdbc-url: jdbc:mysql://localhost:3306/xu?useSSL=false
? ? ? ? username: root
? ? ? ? password: 1234
? ? second:
? ? ? ? jdbc-url: jdbc:mysql://localhost:3306/hua?useSSL=false
? ? ? ? username: root
? ? ? ? password: 1234
PrimaryDatasourceConfig:
@Configuration
@MapperScan(basePackages = PrimaryDatasourceConfig.PACKAGE,sqlSessionFactoryRef = "primarySqlSessionFactory")
public class PrimaryDatasourceConfig {
? ? static final String PACKAGE = "com.xu.scaffold.repository.primary";
? ? @Bean(name = "primaryDataSource")
? ? @Primary
? ? @ConfigurationProperties(prefix = "hikari.primary")
? ? public HikariDataSource dataSource() {
? ? ? ? return new HikariDataSource();
? ? }
? ? @Bean(name = "primaryTransactionManager")
? ? @Primary
? ? public DataSourceTransactionManager transactionManager() {
? ? ? ? return new DataSourceTransactionManager(this.dataSource());
? ? }
? ? @Bean(name = "primarySqlSessionFactory")
? ? @Primary
? ? public SqlSessionFactory sqlSessionFactory(@Qualifier("primaryDataSource") DataSource dataSource) throws Exception {
? ? ? ? final SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean();
? ? ? ? sessionFactory.setDataSource(dataSource);
? ? ? ? sessionFactory.getObject().getConfiguration().setMapUnderscoreToCamelCase(true);
? ? ? ? return sessionFactory.getObject();
? ? }
}
SecondDatasourceConfig:
@Configuration
@MapperScan(basePackages = SecondDatasourceConfig.PACKAGE, sqlSessionFactoryRef = "secondSqlSessionFactory")
public class SecondDatasourceConfig {
? ? static final String PACKAGE = "com.xu.scaffold.repository.second";
? ? @Bean(name = "secondDataSource")
? ? @ConfigurationProperties(prefix = "hikari.second")
? ? public HikariDataSource dataSource() {
? ? ? ? return new HikariDataSource();
? ? }
? ? @Bean(name = "secondTransactionManager")
? ? public DataSourceTransactionManager transactionManager() {
? ? ? ? return new DataSourceTransactionManager(this.dataSource());
? ? }
? ? @Bean(name = "secondSqlSessionFactory")
? ? public SqlSessionFactory sqlSessionFactory(@Qualifier("secondDataSource") DataSource dataSource) throws Exception {
? ? ? ? final SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean();
? ? ? ? sessionFactory.setDataSource(dataSource);
? ? ? ? sessionFactory.getObject().getConfiguration().setMapUnderscoreToCamelCase(true);
? ? ? ? return sessionFactory.getObject();
? ? }
}
總結(jié)
以上是生活随笔為你收集整理的HikariConfig配置详解的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: rac下重做控制文件
- 下一篇: hibernate执行sql的顺序问题