数据源: 配置: 连接缓冲池 （JDBC Data Source: Configuration: Connection Pool JDBC）

The connection pool within a JDBC data source contains a group of JDBC connections that applications reserve, use, and then return to the pool. The connection pool and the connections within it are created when the connection pool is registered, usually when starting up WebLogic Server or when deploying the data source to a new target.

Use this page to define the configuration for this data source's connection pool.

JDBC 数据源中的连接缓冲池包含一组 JDBC 连接，应用程序保留、使用这些连接，然后将其返回缓冲池。连接缓冲池及其中的连接是在注册此连接缓冲池时（通常在启动 WebLogic Server 或将数据源部署到新的目标时）创建的。

使用此页可以定义该数据源的连接缓冲池的配置。

Configuration Options

名称	描述
URL	要连接到的数据库的 URL。URL 的格式随 JDBC 驱动程序的不同而变化。 将 URL 传递给 JDBC 驱动程序以创建物理数据库连接。 MBean 特性 （不适用于应用程序模块）: JDBCDriverParamsBean.Url 更改将在重新部署模块或重新启动服务器后生效。
Driver Class Name 驱动程序类名称	用于在连接缓冲池中创建物理数据库连接的 JDBC 驱动程序类的完整包名。（请注意，此驱动程序类必须存在于将其部署到的任何服务器的类路径中。） MBean 特性 （不适用于应用程序模块）:  JDBCDriverParamsBean.DriverName 更改将在重新部署模块或重新启动服务器后生效。
Properties 属性	传递给创建物理数据库连接时使用的 JDBC 驱动程序的属性的列表。例如：server=dbserver1。请分别在单独的行上列出各个 property=value 对。 要启用驱动程序级功能，请将驱动程序属性及其值添加到“属性”列表。WebLogic Server 设置驱动程序的 ConnectionPoolDataSource 对象上的“属性”列表中的驱动程序级属性。 注意: 　　由于安全方面的原因，当 WebLogic Server 以生产模式运行时，您不能在此属性列表中指定数据库密码。如果在此属性列表中指定密码，那么数据源部署将会失败。 　　要替代此安全检查，请在启动此服务器时使用命令行参数 "weblogic.management.allowClearTextPasswords"。 MBean 特性 （不适用于应用程序模块）:  JDBCDriverParamsBean.Properties 更改将在重新部署模块或重新启动服务器后生效。
Password 密码	创建物理数据库连接时传递给 JDBC 驱动程序的密码属性。 该值以加密形式存储在描述符文件及显示在“管理控制台”中。 MBean 特性 （不适用于应用程序模块）:  JDBCDriverParamsBean.Password 更改将在重新部署模块或重新启动服务器后生效。
lnitial Capacity 初始容量	要在创建连接缓冲池时创建的物理连接数。 如果无法创建这一数量的连接，创建此连接缓冲池的操作将会失败。此连接数也是连接缓冲池将保持的最小可用物理连接数。 最小值: 0 最大值: 2147483647
Maximum Capacity 最大容量	此连接缓冲池可容纳的最大物理连接数。
Capacity Increment 容量增长	将新连接添加到连接缓冲池时创建的连接数。 不再有可用的物理连接来满足连接请求时，WebLogic Server 会创建该数量的附加物理连接并将它们添加到连接缓冲池中。MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.CapacityIncrement 最小值: 1  　　最大值: 2147483647
Statement Cache Type 语句缓存类型	用于维护存储在语句缓存中的准备就绪的语句的算法。 选项有： LRU - 当使用新的预处理或可调用语句时，替换缓存中最近最少使用的语句。 FIXED - 缓存前若干个固定数量的预处理和可调用语句。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.StatementCacheType
Statement Cache Size 语句缓存大小	存储在缓存中的预处理语句和可调用语句的数量。（这样可能会提高服务器性能。） WebLogic Server 可以重用缓存中的语句而无需重新加载它们，这样便可提高服务器性能。连接缓冲池中的每个连接都有其自己的语句缓存。 将语句缓存的大小设置为 0 将会关闭该语句缓存。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.StatementCachSize 最小值: 0 最大值: 1024

  Advanced Configuration Options　　

高级配置选项 

Name　　名称	Description　　描述
Test Table Name	测试物理数据库连接时使用的数据库表名。指定“测试频率”和启用“测试保留的连接数”时需要此名称。 用于测试连接的默认 SQL 代码为“select count(*) from TestTableName” 大多数数据库服务器会优化此 SQL 以避免对表进行扫描，但仍然建议将“测试表名称”设置为已知包含极少的行或不包含行的表的名称。 如果“测试表名称”以“SQL ”开头，则此开始标记后面的字符串剩余部分将被视为用于测试连接的 SQL 语句文字而非标准查询。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.TestTableName
Init SQL 初始 SQL	要执行的、将初始化新建物理数据库连接的 SQL 语句。以 SQL 后跟一个空格作为语句的开头。 如果“初始 SQL”值以“SQL ”开头，则此开始标记后面的字符串剩余部分将被视为用于初始化数据库连接的 SQL 语句文字。如果“初始 SQL”值不以“SQL ”开头，该值将被视为表格的名称，并会使用下列 SQL 语句来初始化连接：  “select count(*) from InitSQL” 表 InitSQL 必须存在且此连接的数据库用户必须能够访问它。大多数数据库服务器会优化此 SQL 以避免对表进行扫描，但仍然建议将 InitSQL 设置为已知包含极少的行或不包含行的表的名称。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.InitSql 更改将在重新部署模块或重新启动服务器后生效。
Test Connections On Reserve 保留时测试连接	使 WebLogic Server 能够在将连接提供给客户端之前对连接进行测试。（要求指定“测试表名称”。） 此测试在响应客户端对缓冲池中的连接的请求时将添加短时间的延迟，但会确保客户端收到有效连接。 对于使用故障转移算法的在多数据源中使用的连接缓冲池，该测试是必需的。 更改将在重新部署模块或重新启动服务器后生效。
Test Frequency 测试频率	WebLogic Server 对未用连接进行测试的间隔秒数。（要求指定“测试表名称”。）未通过测试的连接将被关闭，然后将它们重新打开以重新建立有效的物理连接。如果测试再次失败，则此连接将被关闭。 如果设置为 0，定期测试将被禁用。 更改将在重新部署模块或重新启动服务器后生效。
Seconds to Trust an Idle Pool Connection 信任空闲缓冲池连接的秒数	在将连接传递到应用程序之前或定期连接测试过程期间，WebLogic Server 相信连接仍然有效并将跳过连接测试时使用连接的秒数。 此选项是一种最佳选择，可以最大程度地减少连接测试对性能造成的影响（特别是在流量很大的时候）。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.SecondsToTrustAnIdlePoolConnection 最小值: 0　　最大值: 2147483647
Shrink Frequency 收缩频率	在收缩为满足需要而增大了的连接缓冲池前需等待的秒数。 如果设置为 0，收缩将被禁用。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ShrinkFrequencySeconds 最小值: 0　　最大值: 2147483647
Connection Creation Retry Frequency 重试创建连接的频率	建立数据库连接尝试的间隔秒数。 如果不设置此值，则在数据库不可用的情况下，创建数据源的操作将失败。如果已设置此值且在创建数据源时数据库不可用，则在您指定的秒数之后，WebLogic Server 将重新尝试在缓冲池中创建连接，并会不断尝试创建连接，直到创建成功。 如果设置为 0，连接重试将被禁用。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ConnectionCreationRetryFrequencySeconds 最小值: 0 最大值: 2147483647
Login Delay 登录延迟	创建每个物理数据库连接前的延迟秒数。此延迟支持不能快速连续处理多个连接请求的数据库服务器。 在初始数据源创建及数据源生命周期内，每当创建物理数据库连接时都会有此延迟。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.LoginDelaySeconds 最小值: 0 最大值: 2147483647 更改将在重新部署模块或重新启动服务器后生效。
Profile Connection Usage 配置文件连接使用情况	收集与当前正在使用数据源的连接缓冲池中连接的线程有关的配置文件信息。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ProfileType
Profile Connection Reservation Wait 配置文件连接保留等待	收集有关当前等待保留数据源连接的线程的配置文件信息。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ProfileType
Profile Connection Leak 配置文件连接泄漏	收集有关已保留数据源中连接和泄漏连接（未正确返回到连接缓冲池）的线程的配置文件信息。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ProfileType
Profile Connection Reservation Failed 配置文件连接保留失败	Collect profile information about threads that attempt to reserve a connection from the data source but fail. MBean Attribute (Does not apply to application modules) :  JDBCConnectionPoolParamsBean.ProfileType 收集与尝试保留数据源连接但却失败的线程有关的配置文件信息。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ProfileType
Profile Statement Cache Entry  配置文件语句缓存条目	为添加到语句缓存中的预处理语句和 可调用语句，以及执行缓存语句的线程，收集配置文件信息。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ProfileType
Profile Statement Usage 配置文件语句使用情况	收集与当前正在执行语句缓存中 SQL 语句的线程相关的配置文件信息。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ProfileType
Profile Connection Last Usage 配置文件连接上次使用情况	收集有关最后使用此连接的上一线程的配置文件信息。 在调试由待定事务占用的连接的问题（导致这些连接上的后续 XA 操作失败）时，此信息非常有用。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ProfileType
Profile Connection Multithreaded Usage 配置文件连接多线程使用情况	收集有关线程的配置文件信息，这些线程错误地使用了先前由其他线程获取的连接。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ProfileType
Profile Harvest Frequency Seconds 配置文件结果频率秒数	WebLogic Server 收集配置文件数据的间隔秒数。 如果设置为 0，数据收集将被禁用。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ProfileHarvestFrequencySeconds 最小值: 0　　最大值: 2147483647
Driver Interceptor 驱动程序侦听器	指定用于截获对 JDBC 驱动程序的方法调用的应用程序类的绝对名。指定的应用程序必须实现 weblogic.jdbc.extensions.DriverInterceptor 接口。 在调用 JDBC 驱动程序内的任何方法之前和之后，Weblogic Server 将调用已注册应用程序的 preInvokeCallback()、postInvokeExceptionCallback() 和 postInvokeCallback() 方法。可使用此功能配置 JDBC 驱动程序的使用情况和监视： 正在执行的方法 引发的任何异常 在驱动程序执行方法过程中花费的时间 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.DriverInterceptor 更改将在重新部署模块或重新启动服务器后生效。
Set Client ID On Connection 启用凭据映射	为该数据源启用凭据映射。应用程序请求数据库连接时，WebLogic Server 根据数据库 ID 映射在该数据库连接上设置一个轻型客户端 ID。 还要必须指定 WebLogic Server 用户 ID 到数据库用户 ID 的映射（凭据映射）。 此功能依赖于 JDBC 驱动程序和 DBMS 中的功能。并非所有驱动程序和 DBMS 都支持此功能。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.CredentialMappingEnabled 更改将在重新部署模块或重新启动服务器后生效。
Inactive Connection Timeout 非活动连接超时	保留连接处于不活动状态的秒数，该秒数过后 WebLogic Server 将收回该连接并将其释放回连接缓冲池。 可以使用“非活动连接超时”功能收回泄漏的连接 - 未由应用程序显式关闭的连接。请注意，不能使用此功能来代替正常关闭连接。 如果设置为 0，此功能将被禁用。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.InactiveConnectionTimeoutSeconds 最小值: 0　　最大值: 2147483647
Maximum Waiting for Connection 最大等待连接数	等待保留数据源的连接缓冲池中的连接时会阻塞线程的最大并发连接请求数。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.HighestNumWaiters 最小值: 0　　最大值: 2147483647
Connection Reserve Timeout 连接保留超时	保留连接缓冲池中的连接的调用超时之前经过的秒数。 如果设置为 0，则调用永远不会超时。 如果设置为 -1，则调用立即超时。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.ConnectionReserveTimeoutSeconds 最小值: -1　　最大值: 2147483647
Statement Timeout 语句超时	此时间后当前正在执行的语句将超时。 StatementTimeout 依赖于底层 JDBC 驱动程序支持。WebLogic Server 使用 java.sql.Statement.setQueryTimeout() 方法将指定的时间传递给 JDBC 驱动程序。如果 JDBC 驱动程序不支持此方法，可能会引发异常并导致超时值被忽略。 值为 -1 时禁用此功能。 值为 0 表示语句不会超时。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.StatementTimeout 最小值: -1　　最大值: 2147483647 更改将在重新部署模块或重新启动服务器后生效。
Ignore In-Use Connections 忽略正在使用的连接	即便仍在使用从缓冲池获取的连接，也能够将数据源关闭。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.IgnoreInUseConnectionsEnabled 更改将在重新部署模块或重新启动服务器后生效。
Pinned-To-Thread 固定到线程	PinnedToThread 是一个能够改善性能的选项，它启用执行线程以保持已进入缓冲池的数据库连接，即使在应用程序关闭逻辑连接之后。 启用 PinnedToThread 后，WebLogic Server 将在应用程序首次使用某个执行线程保留连接时把连接缓冲池中的一个数据库连接固定到此线程。当应用程序使用完此连接并调用 connection.close()（此方法在其他情况下将把连接返回到连接缓冲池）时，WebLogic Server 将把该连接保留给执行线程，而不会将其返回连接缓冲池。当此后某个应用程序使用相同的执行线程请求连接时，WebLogic Server 将提供此线程已保留的这个连接。 使用 PinnedToThread，当多个线程尝试同时保留一个连接时，连接缓冲池上不会发生锁定冲突，对于试图在有限个数的数据库连接中保留同一个连接的线程，也没有冲突。 如果应用程序使用相同的执行线程同时保留连接缓冲池中的多个连接，WebLogic Server 将创建附加的数据库连接并同样将它们固定到此线程。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.PinnedToThread 更改将在重新部署模块或重新启动服务器后生效。
Remove Infected Connections Enabled 已启用删除受影响的连接	指定在应用程序使用底层供应商连接对象之后是否从连接缓冲池中删除连接。 如果禁止删除已占用的连接，必须确保该数据库连接适合被其他应用程序重复使用。 设置为 true（默认设置）时，应用程序关闭逻辑连接后将不把物理连接返回给连接缓冲池。将关闭并重新创建此物理连接。 设置为 false 时，应用程序关闭逻辑连接后，物理连接将返回到连接缓冲池并可由该应用程序或其他应用程序重复使用。 MBean 特性 （不适用于应用程序模块）:  JDBCConnectionPoolParamsBean.RemoveInfectedConnections 更改将在重新部署模块或重新启动服务器后生效。