| name |
- |
配置这个属性的意义在于，如果存在多个数据源，监控时可以通过名字来区分开来 。 如果没有配置，将会生成一个名字，格式是： “DataSource-“ + System.identityHashCode(this) . 另外配置此属性至少在 1.0.5 版本中是不起作用的，强行设置 name 会出错 。 |
| url |
- |
连接数据库的url |
| username |
- |
连接数据库的用户名 |
| password |
- |
连接数据库的密码 |
| driverClassName |
根据 url 自动识别 |
这一项可配可不配，如果不配置 druid 会根据 url 自动识别 dbType ，然后选择相应的 driverClassName。 |
| initialSize |
0 |
初始化时建立物理连接的个数 。 初始化发生在显示调用 init 方法，或者第一次 getConnection 时。 |
| maxActive |
8 |
最大连接池数量。 |
| maxIdle |
8 |
已废弃 |
| minIdle |
- |
最小连接池数量。 |
| maxWait |
- |
获取连接时最大等待时间，单位毫秒 。 配置了 maxWait 之后，缺省启用公平锁，并发效率会有所下降，如果需要可以通过配置 useUnfairLock 属性为 true 使用非公平锁 。 |
| poolPreparedStatements |
false |
是否缓存 preparedStatement ，也就是 PSCache。PSCache 对支持游标的数据库性能提升巨大，比如说 oracle。 在 mysql 下建议关闭 。 |
| maxPoolPreparedStatementPerConnectionSize |
-1 |
要启用 PSCache ，必须配置大于 0 ，当大于 0 时， poolPreparedStatements 自动触发修改为 true。 在 Druid 中，不会存在 Oracle 下 PSCache 占用内存过多的问题，可以把这个数值配置大一些，比如说 100 。 |
| validationQuery |
- |
用来检测连接是否有效的 sql ，要求是一个查询语句，常用 select ‘x’。 如果 validationQuery 为 null ， testOnBorrow、testOnReturn、testWhileIdle 都不会起作用 。 |
| validationQueryTimeout |
- |
单位：秒，检测连接是否有效的超时时间 。 底层调用 jdbc Statement 对象的 void setQueryTimeout(int seconds) 方法。 |
| testOnBorrow |
true |
申请连接时执行 validationQuery 检测连接是否有效，做了这个配置会降低性能 。 |
| testOnReturn |
false |
归还连接时执行 validationQuery 检测连接是否有效，做了这个配置会降低性能 。 |
| testWhileIdle |
false |
建议配置为 true ，不影响性能，并且保证安全性 。 申请连接时检测，如果空闲时间大于 timeBetweenEvictionRunsMillis ，执行 validationQuery 检测连接是否有效 。 |
| keepAlive |
false(1.0.28+) |
连接池中的 minIdle 数量以内的连接，空闲时间超过 minEvictableIdleTimeMillis ，则会执行 keepAlive 操作 。 |
| timeBetweenEvictionRunsMillis |
1分钟（1.0.14+） |
有两个含义： 1) Destroy 线程会检测连接的间隔时间，如果连接空闲时间大于等于 minEvictableIdleTimeMillis 则关闭物理连接 。 2) testWhileIdle 的判断依据，详细看 testWhileIdle 属性的说明。 |
| numTestsPerEvictionRun |
30分钟（1.0.14+） |
不再使用，一个 DruidDataSource 只支持一个 EvictionRun 。 |
| minEvictableIdleTimeMillis |
- |
连接保持空闲而不被驱逐的最小时间。 |
| connectionInitSqls |
- |
物理连接初始化时执行的 sql 。 |
| exceptionSorter |
根据 dbType 自动识别 |
当数据库抛出一些不可恢复的异常时，抛弃连接。 |
| filters |
- |
属性类型是字符串，通过别名的方式配置扩展插件，常用的插件有： 监控统计用的 filter:stat 日志用的 filter:log4j 防御 sql 注入的 filter:wall 。 |
| proxyFilters |
- |
类型是 List<com.alibaba.druid.filter.Filter> ，如果同时配置了 filters 和 proxyFilters ，是组合关系，并非替换关系。 |
| asyncInit |
false（1.1.4+） |
如果 initialSize 数量较多时，打开会加快应用启动时间。 |
| useUnfairLock |
false |
是否使用非公平锁。需要平衡锁的公平和效率的关系。在连接不够用，发生争用时， unfair 模式的 ReentrantLock.tryLock 方法会存在严重不公的现象，个别线程会等到超时了还获取不到连接 。 0.2.8+ 能够兼顾性能和公平性。 |