Druid配置大全

Druid配置大全

Druid是一个开源的数据库连接池，它提供了强大的监控和扩展功能。以下是Druid的主要配置项及其说明：

• name

  配置意义：在存在多个数据源时，通过名字来区分不同的数据源。

  缺省值：如果没有配置，将会生成一个名字，格式为 "DataSource-" + System.identityHashCode(this)。

  注意事项：在1.0.5版本中，配置此属性是不起作用的，强行设置会出错。

• url

  配置意义：连接数据库的URL。

  必配项：是。

• username

  配置意义：连接数据库的用户名。

  必配项：是。

• password

  配置意义：连接数据库的密码。

  必配项：是。

• driverClassName

  配置意义：数据库驱动类名。如果不配置，druid会根据url自动识别dbType，然后选择相应的driverClassName。

  必配项：否。

• initialSize

  配置意义：初始化时建立物理连接的个数。

  缺省值：0。

  说明：初始化发生在显示调用init方法，或者第一次getConnection时。

• maxActive

  配置意义：最大连接池数量。

  缺省值：8。

• maxIdle（已废弃）

  配置意义：曾用于设置最大空闲连接数，但现已被废弃。

• minIdle

  配置意义：最小连接池数量。

  说明：当数据库连接数少于该值时，连接池会尝试建立新的连接。

• maxWait

  配置意义：获取连接时最大等待时间，单位毫秒。

  说明：配置了maxWait之后，缺省启用公平锁，并发效率会有所下降。如果需要，可以通过配置useUnfairLock属性为true使用非公平锁。

• poolPreparedStatements

  配置意义：是否缓存preparedStatement，即PSCache。

  缺省值：false。

  说明：PSCache对支持游标的数据库性能提升巨大，如Oracle。在MySQL下建议关闭。

• maxPoolPreparedStatementPerConnectionSize

  配置意义：要启用PSCache，必须配置大于0。当大于0时，poolPreparedStatements自动触发修改为true。

  缺省值：-1。

  说明：在Druid中，不会存在Oracle下PSCache占用内存过多的问题，可以把这个数值配置大一些，如100。

• validationQuery

  配置意义：用来检测连接是否有效的SQL，要求是一个查询语句，常用select 'x'。

  说明：如果validationQuery为null，testOnBorrow、testOnReturn、testWhileIdle都不会起作用。

• validationQueryTimeout

  配置意义：检测连接是否有效的超时时间，单位秒。

  说明：底层调用jdbc Statement对象的void setQueryTimeout(int seconds)方法。

• testOnBorrow

  配置意义：申请连接时执行validationQuery检测连接是否有效。

  缺省值：true。

  说明：做了这个配置会降低性能。

• testOnReturn

  配置意义：归还连接时执行validationQuery检测连接是否有效。

  缺省值：false。

  说明：做了这个配置会降低性能。

• testWhileIdle

  配置意义：建议配置为true，不影响性能，并且保证安全性。申请连接时检测，如果空闲时间大于timeBetweenEvictionRunsMillis，执行validationQuery检测连接是否有效。

  缺省值：false。

• keepAlive（1.0.28+）

  配置意义：连接池中的minIdle数量以内的连接，空闲时间超过minEvictableIdleTimeMillis，则会执行keepAlive操作。

  缺省值：false。

• timeBetweenEvictionRunsMillis（1.0.14+）

  配置意义：Destroy线程会检测连接的间隔时间，如果连接空闲时间大于等于minEvictableIdleTimeMillis则关闭物理连接。同时也是testWhileIdle的判断依据。

  缺省值：1分钟。

• numTestsPerEvictionRun（1.0.14+）

  配置意义：不再使用，一个DruidDataSource只支持一个EvictionRun。

• minEvictableIdleTimeMillis

  配置意义：连接保持空闲而不被驱逐的最小时间。

• connectionInitSqls

  配置意义：物理连接初始化时执行的SQL。

• exceptionSorter

  配置意义：根据dbType自动识别当数据库抛出一些不可恢复的异常时，抛弃连接。

• filters

  配置意义：通过别名的方式配置扩展插件，常用的插件有：监控统计用的filter:stat，日志用的filter:log4j，防御SQL注入的filter:wall。

  类型：字符串。

• proxyFilters

  配置意义：如果同时配置了filters和proxyFilters，是组合关系，并非替换关系。

  类型：List<com.alibaba.druid.filter.Filter>。

• asyncInit（1.1.4+）

  配置意义：如果initialSize数量较多时，打开会加快应用启动时间。

  缺省值：false。

• useUnfairLock

  配置意义：是否使用非公平锁。需要平衡锁的公平和效率的关系。

  缺省值：false。

  说明：在连接不够用，发生争用时，unfair模式的ReentrantLock.tryLock方法会存在严重不公的现象，个别线程会等到超时了还获取不到连接。0.2.8+能够兼顾性能和公平性。

以上是Druid的主要配置项及其说明，根据实际需求进行配置可以优化数据库连接池的性能和安全性。