阿里Druid简介及配置参数

目录

Druid是什么？

在哪里下载druid

怎么获取Druid的源码

怎么配置maven

参数详解

---

Druid是什么？

Druid是一个由阿里开源的数据库连接池，Druid的配置非常丰富连接池。同时提供强大的监控和扩展功能。

在哪里下载druid

• 正式版本下载：
  maven中央仓库: http://central.maven.org/maven2/com/alibaba/druid/

怎么获取Druid的源码

Druid是一个开源项目，源码托管在github上，源代码仓库地址是https://github.com/alibaba/druid。同时每次Druid发布正式版本和快照的时候，都会把源码打包，你可以从上面的下载地址中找到相关版本的源码。

怎么配置maven

Druid 0.1.18 之后版本都发布到maven中央仓库中，所以你只需要在项目的pom.xml中加上dependency就可以了。例如：

<dependency>
		<groupId>com.alibaba</groupId>
		<artifactId>druid</artifactId>
		<version>${druid-version}</version>
	</dependency>

也可以选择 Maven仓库查找公共的仓库地址: http://www.mvnrepository.com/artifact/com.alibaba/druid

参数详解

DruidDataSource配置属性列表 · alibaba/druid Wiki · GitHub

-- 项目中常用配置
spring.account.url=jdbc:mysql://xxxxx:6000/account?useUnicode=true&autoReconnect=true&&zeroDateTimeBehavior=convertToNull
spring.account.username=xxxx
spring.account.password=xxxx
spring.account.driver-class-name=com.mysql.jdbc.Driver
spring.account.max-active=200
spring.account.min-idle=10
spring.account.max-wait=10000
spring.account.initial-size=5
spring.account.validation-query=SELECT 1
spring.account.test-on-borrow=false
spring.account.test-while-idle=true
spring.account.time-between-eviction-runs-millis=18800
spring.account.jdbc-interceptors=ConnectionState;

配置	缺省值	说明
name		配置这个属性的意义在于，如果存在多个数据源，监控的时候可以通过名字来区分开来。如果没有配置，将会生成一个名字，格式是："DataSource-" + System.identityHashCode(this). 另外配置此属性至少在1.0.5版本中是不起作用的，强行设置name会出错。详情-点此处。
url		连接数据库的url，不同数据库不一样。例如： mysql : jdbc:mysql://10.20.153.104:3306/druid2 oracle : jdbc:oracle:thin:@10.20.149.85:1521:ocnauto
username		连接数据库的用户名
password		连接数据库的密码。如果你不希望密码直接写在配置文件中，可以使用ConfigFilter。详细看这里
driverClassName	根据url自动识别	这一项可配可不配，如果不配置druid会根据url自动识别dbType，然后选择相应的driverClassName
initialSize	0	初始化时建立物理连接的个数。初始化发生在显示调用init方法，或者第一次getConnection时
maxActive	8	最大连接池数量 连接池中的连接包含3部分 activeCount：正在使用的连接； poolingCount：连接池中的空闲连接； createTaskCount：正在生成的连接； 这三部分的连接总和不能超过maxActive； 数据库的连接总数是有限制的，有时候僧多粥少，只能限制每个应用的连接数
maxIdle	8	已经不再使用，配置了也没效果
minIdle		最小连接池数量 连接池中的最小空闲连接数，Druid会定时扫描连接池的连接，如果空闲的连接数大于该值，则关闭多余的连接，反之则创建更多的连接以满足最小连接数要求。 目的:设置这个参数可以应对突发流量，如果没有设置空闲连接，当有多个请求同时调用数据库，但是连接池中并没有可用连接，这时就必须创建连接，创建连接是一个非常耗时的操作，有可能会导致请求超时。 如何确保:当连接池初始化时，会初始化一个定时清除空闲连接的任务DestroyTask，该任务默认是1分钟执行一次（使用timeBetweenEvictionRunsMillis参数设置) 在这个定时任务中会判断连接池的连接是否满足关闭的条件，如果满足则关闭，满足的条件如下： 空闲时间大于minEvictableIdleTimeMillis（默认30分钟），并且空闲连接数大于minIdle； 空闲时间大于maxEvictableIdleTimeMillis（默认7小时）； 当然也有可能这时数据库中的连接数小于minIdle这个时候就需要创建新的连接了
maxWait		获取连接时最大等待时间，单位毫秒。默认-1，即会一直等待下去，配置了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，是组合关系，并非替换关系