HikariDataSource 配置详解
生活随笔
收集整理的這篇文章主要介紹了
HikariDataSource 配置详解
小編覺得挺不錯的,現在分享給大家,幫大家做個參考.
#數據源類型
spring.datasource.type=com.zaxxer.hikari.HikariDataSource
#連接池名稱,默認HikariPool-1
spring.datasource.hikari.pool-name=KevinHikariPool
#最大連接數,小于等于0會被重置為默認值10;大于零小于1會被重置為minimum-idle的值
spring.datasource.hikari.maximum-pool-size=12
#連接超時時間:毫秒,小于250毫秒,否則被重置為默認值30秒
spring.datasource.hikari.connection-timeout=60000
#最小空閑連接,默認值10,小于0或大于maximum-pool-size,都會重置為maximum-pool-size
spring.datasource.hikari.minimum-idle=10
#空閑連接超時時間,默認值600000(10分鐘),大于等于max-lifetime且max-lifetime>0,會被重置為0;不等于0且小于10秒,會被重置為10秒。
# 只有空閑連接數大于最大連接數且空閑時間超過該值,才會被釋放
spring.datasource.hikari.idle-timeout=500000
#連接最大存活時間.不等于0且小于30秒,會被重置為默認值30分鐘.設置應該比mysql設置的超時時間短
spring.datasource.hikari.max-lifetime=540000
#連接測試查詢
spring.datasource.hikari.connection-test-query=SELECT 1
idleTimeout
默認是600000毫秒,即10分鐘。如果idleTimeout+1秒>maxLifetime 且 maxLifetime>0,則會被重置為0;如果idleTimeout!=0且小于10秒,則會被重置為10秒。如果idleTimeout=0則表示空閑的連接在連接池中永遠不被移除。
只有當minimumIdle小于maximumPoolSize時,這個參數才生效,當空閑連接數超過minimumIdle,而且空閑時間超過idleTimeout,則會被移除。
minimumIdle
控制連接池空閑連接的最小數量,當連接池空閑連接少于minimumIdle,而且總共連接數不大于maximumPoolSize時,HikariCP會盡力補充新的連接。為了性能考慮,不建議設置此值,而是讓HikariCP把連接池當做固定大小的處理,默認minimumIdle與maximumPoolSize一樣。
當minIdle<0或者minIdle>maxPoolSize,則被重置為maxPoolSize,該值默認為10。
完整配置項如下:
| 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 | 如果您的驅動程序支持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 | – |
完整配置項如下:
總結
以上是生活随笔為你收集整理的HikariDataSource 配置详解的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: jQuery教程——jQuery的快速入
- 下一篇: GUI 图形用户界面编程实例-记事本的设