您的位置:

Hikari连接池配置详解

一、Hikari连接池详解

Hikari连接池是一个高性能的开源JDBC连接池,它为开发人员提供了高效的JDBC连接管理,尤其适用于高并发应用程序。Hikari连接池支持自动轮询、动态调整连接池大小,可以自动回收不使用的连接等,可以提高系统的可用性和性能。

在使用Hikari连接池之前,我们需要先了解Hikari连接池的配置和使用方式。下面将详细介绍Hikari连接池的配置方法。

二、Hikari配置xml和yml

在使用Hikari连接池之前,需要进行相关的配置。Hikari连接池提供了两种配置方式,一种是使用XML配置,另一种是使用YAML(YAML Ain't Markup Language)格式的配置文件。

1、Hikari配置XML

以下是一个Hikari连接池的XML配置文件例子:

<?xml version="1.0" encoding="UTF-8"?>
<hikari>
  <dataSource>
    <className>com.mysql.jdbc.jdbc2.optional.MysqlDataSource</className>
    <url>jdbc:mysql://localhost:3306/mydb</url>
    <username>root</username>
    <password>password</password>
  </dataSource>
  <pool>
    <minimumIdle>5</minimumIdle>
    <maximumPoolSize>10</maximumPoolSize>
    <poolName>testPool</poolName>
  </pool>
</hikari>

以上XML配置文件定义了MySQL数据库的数据源信息,包括驱动程序类名、数据库URL、用户名和密码。配置文件还定义了连接池信息,包括连接池中的最小空闲连接数、最大连接数和连接池的名称。

2、Hikari配置YAML

以下是一个Hikari连接池的YAML配置文件例子:

  dataSource:
    className: com.mysql.jdbc.jdbc2.optional.MysqlDataSource
    url: jdbc:mysql://localhost:3306/mydb
    username: root
    password: password
  pool:
    minimumIdle: 5
    maximumPoolSize: 10
    poolName: testPool

以上YAML配置文件定义了MySQL数据库的数据源信息,包括驱动程序类名、数据库URL、用户名和密码。配置文件还定义了连接池信息,包括连接池中的最小空闲连接数、最大连接数和连接池的名称。

三、Hikari数据库连接池配置

在使用Hikari连接池时,需要根据实际情况进行数据库连接池的配置,以保证连接池的性能和可用性。以下是一些常用的Hikari数据库连接池的相关配置选项。

1、连接池大小

连接池的大小对应maximumPoolSize参数,如下所示:

  pool:
    maximumPoolSize: 10

连接池的大小根据实际需求进行配置,不建议将其设置过大或过小。一般情况下保持在10 ~ 20条连接比较合适。

2、最小空闲连接数

最小空闲连接数对应minimumIdle参数,如下所示:

  pool:
    minimumIdle: 5

最小空闲连接数是指连接池中保留的最小空闲连接数,当连接池中的连接数小于这个值时,连接池会自动创建新的连接以满足需求。一般情况下,最小空闲连接数设置为连接池大小的一半。

3、连接超时时间

连接超时时间对应connectionTimeout参数,如下所示:

  pool:
    connectionTimeout: 30000

连接超时时间是指当连接池中的所有连接都忙碌时,连接请求等待的最长时间。连接超时时间设置太短可能导致连接请求失败,设置太长会降低数据库连接池的性能。

4、连接生命周期时间

连接生命周期时间对应maxLifetime参数,如下所示:

  pool:
    maxLifetime: 600000

连接生命周期时间是指数据库连接最长的存活时间,超过这个时间的连接将被回收。连接生命周期时间设置适当可以防止连接池中的连接失效。

四、Hikari配置详解

除了上述常用的Hikari连接池配置参数之外,还有一些其他的配置参数需要了解,下面将逐一介绍。

1、自定义数据源

在使用Hikari连接池时,可以通过实现javax.sql.DataSource接口的方式来自定义数据源,如下所示:

public class MyDataSource implements DataSource {
    // 自定义数据源相关代码
}

在定义完自定义数据源之后,可以在Hikari配置文件中进行引用,如下所示:

  dataSource:
    className: com.example.MyDataSource

2、故障的重试

在使用Hikari连接池时,可以配置故障的重试,如下所示:

  pool:
    initializationFailFast: false
    isolateInternalQueries: true
    allowPoolSuspension: false
    readOnly: false
    registerMbeans: false
    catalog: test_catalog
    connectionInitSql: SELECT 1; SELECT 2;

初始化故障检测是指在连接池初始化时,如果某个连接故障了,Hikari连接池会尝试与其建立连接。isolateInternalQueries参数为true时,会自动排除掉事务中的SELECT查询。allowPoolSuspension参数表示是否允许挂起连接池。readOnly参数设置为true时,连接池只能进行读操作。registerMbeans参数设置为true时,Hikari连接池将在MBean服务器上注册一个MBean。catalog参数表示当前连接池所在的目录。connectionInitSql参数可以用于在创建连接时执行SQL语句。

3、心跳检测

在使用Hikari连接池时,可以配置心跳检测,如下所示:

  dataSource:
    idleTimeout: 30000
    leakDetectionThreshold: 60000
    maxLifetime: 1800000
    connectionTestQuery: SELECT 1;
    connectionInitSql: SELECT 1;

idleTimeout参数表示空闲连接的最大存活时间。leakDetectionThreshold参数表示连接泄露检测的时间间隔。maxLifetime参数表示连接池中连接的最大存活时间。connectionTestQuery参数设置为SELECT 1时,每隔一段时间就会执行这个SQL语句,以确保连接池中的连接都是有效的。connectionInitSql参数用于在创建连接时执行SQL语句。

五、Hikari连接池配置参数选取

在使用Hikari连接池时,需要根据实际情况选择合适的连接池配置参数。以下是一些常用配置参数的建议取值。

1、连接池大小

连接池大小应适合当前请求量,一般情况下建议设置为20以下。

2、最小空闲连接数

最小空闲连接数设置为连接池大小的一半比较合适。

3、连接超时时间

连接超时时间建议不要太短,建议设置为30秒以上。

4、连接生命周期时间

连接生命周期时间建议设置为10 ~ 30分钟之间。

5、心跳检测

心跳检测一般情况下无需特别设置,使用默认值即可。

六、Hibernate配置

在使用Hibernate时,需要进行相关的Hikari连接池配置。以下是一个Hibernate的Hikari连接池配置文件例子:

<?xml version="1.0" encoding="UTF-8"?>
<hibernate-configuration>
  <session-factory>
    <property name="hibernate.connection.datasource">java:/comp/env/jdbc/mydb</property>
    <property name="hibernate.connection.username">root</property>
    <property name="hibernate.connection.password">password</property>
    <property name="hibernate.connection.provider_class">org.hibernate.hikaricp.internal.HikariCPConnectionProvider</property>
    <property name="hibernate.hikari.minimumIdle">5</property>
    <property name="hibernate.hikari.maximumPoolSize">10</property>
    <property name="hibernate.hikari.poolName">testPool</property>
  </session-factory>
</hibernate-configuration>

以上Hibernate的Hikari连接池配置文件定义了MySQL数据库的数据源信息和连接池信息,并指定HikariCPConnectionProvider为连接提供者。

七、Hinova10Pro配置

在使用Hinova10Pro时,可以按照以下方式进行Hikari连接池的配置。

1、在build.gradle中添加以下依赖项:

compile 'com.zaxxer:HikariCP:3.3.1'

2、在settings.gradle中指定Hikari连接池配置文件路径:

include 'src/main/resources'

3、在application.yml中进行Hikari连接池的配置:

spring:
  datasource:
    url: jdbc:postgresql://localhost/mydb
    username: root
    password: password
    driver-class-name: org.postgresql.Driver
    type: com.zaxxer.hikari.HikariDataSource
    hikari:
      poolName: default
      minimumIdle: 5
      maximumPoolSize: 20
      connectionTimeout: 30000
      idleTimeout: 60000

以上是使用Hinova10Pro时Hikari连接池的配置方法。

八、Hinova9Se配置参数选取

在使用Hinova9Se时,需要根据实际情况选择合适的Hikari连接池配置参数。以下是一些常用配置参数的建议取值。

1、连接池大小

连接池大小应适合当前请求量,一般情况下建议设置为20以下。

2、最小空闲连接数

最小空闲连接数设置为连接池大小的一半比较合适。

3、连接超时时间

连接超时时间建议不要太短,建议设置为30秒以上。

4、连接生命周期时间

连接生命周期时间建议设置为10 ~ 30分钟之间。

5、心跳检测

心跳检测一般情况下无需特别设置,使用默认值即可。

九、Hikari连接池的MagiskHide配置

在使用Hikari连接池时,如果需要进行一些安全性方面的配置,则可以使用MagiskHide来进行相关的配置。以下是一个使用MagiskHide配置Hikari连接池的例子: