java数据库连接池都有哪些配置参数（都在这里了！） java

在工作中经常要和各种连接池组件打交道，各种参数眼花撩乱，再也不想因为连接池配置光顾度娘了。今天总结的主要是几大常用的数据库连接池配置，redis连接池准备ing。内容主要来自各官方文档。

文章图片

Druid

官方文档： https://github.com/alibaba/dr...

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

Hikari

官方文档： https://github.com/brettwoold...

配置	缺省值	说明	性能优化
autoCommit	true	自动提交从池中返回的连接	/
connectionTimeout	30000ms	等待来自池的连接的最大毫秒数	/
idleTimeout	600000ms	连接允许在池中闲置的最长时间【一个连接idle状态的最大时长（毫秒），超时则被释放（retired），缺省:10分钟】	/
maxLifetime	1800000ms	池中连接最长生命周期	/
keepaliveTime	0 (disabled)	控制 HikariCP 尝试保持连接活动的频率，以防止它被数据库或网络基础设施超时。该值必须小于该 maxLifetime值。“keepalive”只会发生在空闲连接上。当针对给定连接进行“保持连接”的时间到了时，该连接将从池中删除、“ping”，然后返回到池中。'ping' 是其中之一：调用 JDBC4isValid()方法，或执行 connectionTestQuery. 通常，池外的持续时间应该以个位数毫秒甚至亚毫秒为单位进行测量，因此应该几乎没有或没有明显的性能影响。最小允许值为 30000 毫秒（30 秒），默认值：0（禁用）	/
connectionTestQuery	null	如果您的驱动程序支持JDBC4，我们强烈建议您不要设置此属性	建议不设置
minimumIdle	10	池中维护的最小空闲连接数【官方推荐不设置此值，默认同最大连接数相同】	官方推荐不设置此值，默认同最大连接数相同
maximumPoolSize	10	池中最大连接数，包括闲置和使用中的连接	/
metricRegistry	null	该属性允许您指定一个 Codahale / Dropwizard MetricRegistry 的实例，供池使用以记录各种指标	/
healthCheckRegistry	null	该属性允许您指定池使用的Codahale / Dropwizard HealthCheckRegistry的实例来报告当前健康信息	/
poolName	HikariPool-1	连接池的用户定义名称，主要出现在日志记录和JMX管理控制台中以识别池和池配置	/
initializationFailTimeout	1	如果池无法成功初始化连接，则此属性控制池是否将 fail fast	/
isolateInternalQueries	false	是否在其自己的事务中隔离内部池查询，例如连接活动测试	/
allowPoolSuspension	false	控制池是否可以通过JMX暂停和恢复	/
readOnly	false	从池中获取的连接是否默认处于只读模式	/
registerMbeans	false	是否注册JMX管理Bean（MBeans）	/
catalog	null	为支持 catalog 概念的数据库设置默认 catalog	/
connectionInitSql	null	该属性设置一个SQL语句，在将每个新连接创建后，将其添加到池中之前执行该语句。	/
driverClassName	null	HikariCP将尝试通过仅基于jdbcUrl的DriverManager解析驱动程序，但对于一些较旧的驱动程序，还必须指定driverClassName	/
transactionIsolation	null	控制从池返回的连接的默认事务隔离级别	/
validationTimeout	5000	连接将被测试活动的最大时间量	/
leakDetectionThreshold		记录消息之前连接可能离开池的时间量，表示可能的连接泄漏	/
dataSource	null	这个属性允许你直接设置数据源的实例被池包装，而不是让HikariCP通过反射来构造它	/
schema	null	该属性为支持模式概念的数据库设置默认模式	/
threadFactory	null	此属性允许您设置将用于创建池使用的所有线程的java.util.concurrent.ThreadFactory的实例。	/
scheduledExecutor	null	此属性允许您设置将用于各种内部计划任务的java.util.concurrent.ScheduledExecutorService实例	/

DBCP

官方文档： https://commons.apache.org/pr...

配置	缺省值	说明	性能优化	备注
username	null	传递给JDBC驱动的用于建立连接的用户名	/	/
password	null	传递给JDBC驱动的用于建立连接的密码	/	/
url	null	传递给JDBC驱动的用于建立连接的URL	/	/
driverClassName	null	使用的JDBC驱动的完整有效的java 类名	/	/
connectionProperties	null	当建立新连接时被发送给JDBC驱动的连接参数	/	/
defaultAutoCommit	true	连接池创建的连接的默认的auto-commit状态	/	/
defaultReadOnly	driver default	连接池创建的连接的默认的read-only状态. 如果没有设置则setReadOnly方法将不会被调用. (某些驱动不支持只读模式,比如:Informix)	/	/
defaultCatalog	null	连接池创建的连接的默认的catalog	/	/
defaultTransactionIsolation	driver default	连接池创建的连接的默认的TransactionIsolation状态. 下面列表当中的某一个: (参考javadoc)	/	/
initialSize	0	初始化连接:连接池启动时创建的初始化连接数量,1.2版本后支持	/	/
maxActive	8	最大活动连接:连接池在同一时间能够分配的最大活动连接的数量, 如果设置为非正数则表示不限制	/	/
maxIdle	8	最大空闲连接:连接池中容许保持空闲状态的最大连接数量,超过的空闲连接将被释放,如果设置为负数表示不限制	/	/
minIdle	0	最小空闲连接:连接池中容许保持空闲状态的最小连接数量,低于这个数量将创建新的连接,如果设置为0则不创建	/	/
maxWait	无限	最大等待时间:当没有可用连接时,连接池等待连接被归还的最大时间(以毫秒计数), 超过时间则抛出异常,如果设置为-1表示无限等待	/	/
validationQuery	null	SQL查询,用来验证从连接池取出的连接,在将连接返回给调用者之前.如果指定,则查询必须是一个SQL SELECT并且必须返回至少一行记录	/	/
testOnBorrow	true	指明是否在从池中取出连接前进行检验,如果检验失败,则从池中去除连接并尝试取出另一个.注意: 设置为true后如果要生效,validationQuery参数必须设置为非空字符串	/	/
testOnReturn	false	指明是否在归还到池中前进行检验注意: 设置为true后如果要生效,validationQuery参数必须设置为非空字符串	/	/
testWhileIdle	false	指明连接是否被空闲连接回收器(如果有)进行检验.如果检测失败,则连接将被从池中去除.注意: 设置为true后如果要生效,validationQuery参数必须设置为非空字符串	建议使用此设置，代替testOnBorrow	/
timeBetweenEvictionRunsMillis	-1	在空闲连接回收器线程运行期间休眠的时间值,以毫秒为单位. 如果设置为非正数,则不运行空闲连接回收器线程	/	/
numTestsPerEvictionRun	3	在每次空闲连接回收器线程(如果有)运行时检查的连接数量	/	/
minEvictableIdleTimeMillis	1000 60 30	连接在池中保持空闲而不被空闲连接回收器线程(如果有)回收的最小时间值，单位毫秒	/	/
poolPreparedStatements	false	开启池的prepared statement 池功能，当开启时, 将为每个连接创建一个statement池,并且被下面方法创建的PreparedStatements将被缓存起来:	/	/
maxOpenPreparedStatements	0	statement池能够同时分配的打开的statements的最大数量, 如果设置为0表示不限制	/	/
removeAbandoned	false	标记是否删除泄露的连接,如果他们超过了removeAbandonedTimout的限制.如果设置为true, 连接被认为是被泄露并且可以被删除,如果空闲时间超过removeAbandonedTimeout.设置为true可以为写法糟糕的没有关闭连接的程序修复数据库连接.	/	如果开启”removeAbandoned”,那么连接在被认为泄露时可能被池回收. 这个机制在(getNumIdle() < 2) and (getNumActive() > getMaxActive() - 3)时被触发.举例当maxActive=20, 活动连接为18,空闲连接为1时可以触发”removeAbandoned”.但是活动连接只有在没有被使用的时间超过”removeAbandonedTimeout”时才被删除,默认300秒.
removeAbandonedTimeout	300	泄露的连接可以被删除的超时值, 单位秒	/	/
logAbandoned	false	标记当Statement或连接被泄露时是否打印程序的stack traces日志。被泄露的Statements和连接的日志添加在每个连接打开或者生成新的Statement,因为需要生成stack trace。	会导致线程爬栈	/

C3P0

官方文档： https://www.mchange.com/proje...

配置	缺省值	说明	性能优化
acquireIncrement	3	当连接池中的连接耗尽的时，c3p0一次同时创建的连接数	/
acquireRetryAttempts	30	定义在从数据库获取新连接失败后重复尝试的次数	/
acquireRetryDelay	1000	两次连接中间隔时间，单位毫秒	/
autoCommitOnClose	false	连接关闭时默认将所有未提交的操作回滚	/
automaticTestTable	null	c3p0将建一张名为Test的空表，并使用其自带的查询语句进行测试。如果定义了这个参数那么属性preferredTestQuery将被忽略。你不能在这张Test表上进行任何操作，它将只供c3p0测试使用	/
breakAfterAcquireFailure	false	获取连接失败将会引起所有等待连接池来获取连接的线程抛出异常。但是数据源仍有效保留，并在下次调用getConnection()的时候继续尝试获取连接。如果设为true，那么在尝试获取连接失败后该数据源将申明已断开并永久关闭	/
checkoutTimeout	0	当连接池用完时客户端调用getConnection()后等待获取新连接的时间，超时后将抛出SQLException,如设为0则无限期等待	/
connectionTesterClassName	com.mchange.v2.c3p0.impl.DefaultConnectionTester	通过实现ConnectionTester或QueryConnectionTester的类来测试连接。类名需制定全路径	/
forceIgnoreUnresolvedTransactions	false	如果您希望 c3p0 将事务管理留给您，并且既不提交也不回滚（也不修改 Connection autoCommit的状态），您可以将forceIgnoreUnresolvedTransactions设置为 true	作者强烈建议不使用的一个属性
idleConnectionTestPeriod	0	每xxx秒检查所有连接池中的空闲连接	/
initialPoolSize	3	初始化池的连接数，取值应在minPoolSize与maxPoolSize之间	/
maxIdleTime	0	最大空闲时间,xxx秒内未使用则连接被丢弃。若为0则永不丢弃	/
minPoolSize	3	连接池中保留的最小连接数	/
maxPoolSize	15	连接池中保留的最大连接数	/
maxStatements	0	JDBC的标准参数，用以控制数据源内加载的PreparedStatements数量。但由于预缓存的statements属于单个connection而不是整个连接池。所以设置这个参数需要考虑到多方面的因素。如果maxStatements与maxStatementsPerConnection均为0，则缓存被关闭	/
maxStatementsPerConnection	0	maxStatementsPerConnection定义了连接池内单个连接所拥有的最大缓存statements数	/
numHelperThreads	3	帮助配置数据源线程池的行为。默认情况下，每个数据源只有三个关联的辅助线程，负责诸如连接测试工作	/
overrideDefaultUser	null	当用户调用getConnection()时使root用户成为去获取连接的用户。主要用于连接池连接非c3p0的数据源时	/
password	null	密码	/
user	null	/	/
preferredTestQuery	null	定义所有连接测试都执行的测试语句。在使用连接测试的情况下这个一显著提高测试速度。注意：测试的表必须在初始数据源的时候就存在	/
testConnectionOnCheckout	false	因性能消耗大请只在需要的时候使用它。如果设为true那么在每个connection提交的时候都将校验其有效性。	建议使用idleConnectionTestPeriod或automaticTestTable等方法来提升连接测试的性能