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 對象上的“屬性”列表中的驅動程序級屬性。
MBean 特性 （不適用於應用程序模塊）: JDBCDriverParamsBean.Properties 更改將在重新部署模塊或重新啟動服務器后生效。 |
| Password 密碼 |
創建物理數據庫連接時傳遞給 JDBC 驅動程序的密碼屬性。 該值以加密形式存儲在描述符文件及顯示在“管理控制台”中。 MBean 特性 （不適用於應用程序模塊）: JDBCDriverParamsBean.Password 更改將在重新部署模塊或重新啟動服務器后生效。 |
| lnitial Capacity 初始容量 |
要在創建連接緩沖池時創建的物理連接數。 如果無法創建這一數量的連接，創建此連接緩沖池的操作將會失敗。此連接數也是連接緩沖池將保持的最小可用物理連接數。 最小值: |
| Maximum Capacity 最大容量 |
此連接緩沖池可容納的最大物理連接數。 |
| Capacity Increment 容量增長 |
將新連接添加到連接緩沖池時創建的連接數。 不再有可用的物理連接來滿足連接請求時，WebLogic Server 會創建該數量的附加物理連接並將它們添加到連接緩沖池中。MBean 特性 （不適用於應用程序模塊）: JDBCConnectionPoolParamsBean.CapacityIncrement 最小值: |
| Statement Cache Type 語句緩存類型 |
用於維護存儲在語句緩存中的准備就緒的語句的算法。 選項有：
MBean 特性 （不適用於應用程序模塊）: JDBCConnectionPoolParamsBean.StatementCacheType |
| Statement Cache Size 語句緩存大小 |
存儲在緩存中的預處理語句和可調用語句的數量。（這樣可能會提高服務器性能。） WebLogic Server 可以重用緩存中的語句而無需重新加載它們，這樣便可提高服務器性能。連接緩沖池中的每個連接都有其自己的語句緩存。 將語句緩存的大小設置為 0 將會關閉該語句緩存。 MBean 特性 （不適用於應用程序模塊）: JDBCConnectionPoolParamsBean.StatementCachSize 最小值: 最大值: |
Advanced Configuration Options
高級配置選項
| Name 名稱 |
Description 描述 |
| Test Table Name | 測試物理數據庫連接時使用的數據庫表名。指定“測試頻率”和啟用“測試保留的連接數”時需要此名稱。 用於測試連接的默認 SQL 代碼為 大多數數據庫服務器會優化此 SQL 以避免對表進行掃描，但仍然建議將“測試表名稱”設置為已知包含極少的行或不包含行的表的名稱。 如果“測試表名稱”以 MBean 特性 （不適用於應用程序模塊）: JDBCConnectionPoolParamsBean.TestTableName |
| Init SQL 初始 SQL |
要執行的、將初始化新建物理數據庫連接的 SQL 語句。以 SQL 后跟一個空格作為語句的開頭。 如果“初始 SQL”值以 表 MBean 特性 （不適用於應用程序模塊）: JDBCConnectionPoolParamsBean.InitSql 更改將在重新部署模塊或重新啟動服務器后生效。 |
| Test Connections On Reserve 保留時測試連接 |
使 WebLogic Server 能夠在將連接提供給客戶端之前對連接進行測試。（要求指定“測試表名稱”。） 此測試在響應客戶端對緩沖池中的連接的請求時將添加短時間的延遲，但會確保客戶端收到有效連接。 對於使用 更改將在重新部署模塊或重新啟動服務器后生效。 |
| Test Frequency 測試頻率 |
WebLogic Server 對未用連接進行測試的間隔秒數。（要求指定“測試表名稱”。）未通過測試的連接將被關閉，然后將它們重新打開以重新建立有效的物理連接。如果測試再次失敗，則此連接將被關閉。 如果設置為 更改將在重新部署模塊或重新啟動服務器后生效。 |
| Seconds to Trust an Idle Pool Connection 信任空閑緩沖池連接的秒數 |
在將連接傳遞到應用程序之前或定期連接測試過程期間，WebLogic Server 相信連接仍然有效並將跳過連接測試時使用連接的秒數。 此選項是一種最佳選擇，可以最大程度地減少連接測試對性能造成的影響（特別是在流量很大的時候）。 MBean 特性 （不適用於應用程序模塊）: JDBCConnectionPoolParamsBean.SecondsToTrustAnIdlePoolConnection 最小值: |
| Shrink Frequency
收縮頻率 |
在收縮為滿足需要而增大了的連接緩沖池前需等待的秒數。 如果設置為 MBean 特性 （不適用於應用程序模塊）: JDBCConnectionPoolParamsBean.ShrinkFrequencySeconds 最小值: |
| Connection Creation Retry Frequency
重試創建連接的頻率 |
建立數據庫連接嘗試的間隔秒數。 如果不設置此值，則在數據庫不可用的情況下，創建數據源的操作將失敗。如果已設置此值且在創建數據源時數據庫不可用，則在您指定的秒數之后，WebLogic Server 將重新嘗試在緩沖池中創建連接，並會不斷嘗試創建連接，直到創建成功。 如果設置為 MBean 特性 （不適用於應用程序模塊）: 最小值: 最大值: |
|
|
創建每個物理數據庫連接前的延遲秒數。此延遲支持不能快速連續處理多個連接請求的數據庫服務器。 在初始數據源創建及數據源生命周期內，每當創建物理數據庫連接時都會有此延遲。 MBean 特性 （不適用於應用程序模塊）: 最小值: 最大值: 更改將在重新部署模塊或重新啟動服務器后生效。 |
| Profile Connection Usage
配置文件連接使用情況 |
收集與當前正在使用數據源的連接緩沖池中連接的線程有關的配置文件信息。 MBean 特性 （不適用於應用程序模塊）: |
| Profile Connection Reservation Wait
配置文件連接保留等待 |
收集有關當前等待保留數據源連接的線程的配置文件信息。 MBean 特性 （不適用於應用程序模塊）: |
| Profile Connection Leak 配置文件連接泄漏 |
收集有關已保留數據源中連接和泄漏連接（未正確返回到連接緩沖池）的線程的配置文件信息。 MBean 特性 （不適用於應用程序模塊）: |
| 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) : 收集與嘗試保留數據源連接但卻失敗的線程有關的配置文件信息。 MBean 特性 （不適用於應用程序模塊）: |
| Profile Statement Cache Entry 配置文件語句緩存條目 |
為添加到語句緩存中的預處理語句和 可調用語句，以及執行緩存語句的線程，收集配置文件信息。 MBean 特性 （不適用於應用程序模塊）: |
| Profile Statement Usage |
收集與當前正在執行語句緩存中 SQL 語句的線程相關的配置文件信息。 MBean 特性 （不適用於應用程序模塊）: |
| Profile Connection Last Usage |
收集有關最后使用此連接的上一線程的配置文件信息。 在調試由待定事務占用的連接的問題（導致這些連接上的后續 XA 操作失敗）時，此信息非常有用。 MBean 特性 （不適用於應用程序模塊）: |
| 收集有關線程的配置文件信息，這些線程錯誤地使用了先前由其他線程獲取的連接。 MBean 特性 （不適用於應用程序模塊）: |
|
| Profile Harvest Frequency Seconds |
WebLogic Server 收集配置文件數據的間隔秒數。 如果設置為 MBean 特性 （不適用於應用程序模塊）: 最小值: |
| Driver Interceptor 驅動程序偵聽器 |
指定用於截獲對 JDBC 驅動程序的方法調用的應用程序類的絕對名。指定的應用程序必須實現 weblogic.jdbc.extensions.DriverInterceptor 接口。 在調用 JDBC 驅動程序內的任何方法之前和之后，Weblogic Server 將調用已注冊應用程序的 preInvokeCallback()、postInvokeExceptionCallback() 和 postInvokeCallback() 方法。可使用此功能配置 JDBC 驅動程序的使用情況和監視：
MBean 特性 （不適用於應用程序模塊）: |
| Set Client ID On Connection 啟用憑據映射 |
為該數據源啟用憑據映射。應用程序請求數據庫連接時，WebLogic Server 根據數據庫 ID 映射在該數據庫連接上設置一個輕型客戶端 ID。 還要必須指定 WebLogic Server 用戶 ID 到數據庫用戶 ID 的映射（憑據映射）。 此功能依賴於 JDBC 驅動程序和 DBMS 中的功能。並非所有驅動程序和 DBMS 都支持此功能。 MBean 特性 （不適用於應用程序模塊）: |
| Inactive Connection Timeout 非活動連接超時 |
保留連接處於不活動狀態的秒數，該秒數過后 WebLogic Server 將收回該連接並將其釋放回連接緩沖池。 可以使用“非活動連接超時”功能收回泄漏的連接 - 未由應用程序顯式關閉的連接。請注意，不能使用此功能來代替正常關閉連接。 如果設置為 MBean 特性 （不適用於應用程序模塊）: 最小值: |
| Maximum Waiting for Connection 最大等待連接數 |
等待保留數據源的連接緩沖池中的連接時會阻塞線程的最大並發連接請求數。 MBean 特性 （不適用於應用程序模塊）: 最小值: |
| Connection Reserve Timeout 連接保留超時 |
保留連接緩沖池中的連接的調用超時之前經過的秒數。 如果設置為 如果設置為 MBean 特性 （不適用於應用程序模塊）: 最小值: |
| Statement Timeout 語句超時 |
此時間后當前正在執行的語句將超時。 StatementTimeout 依賴於底層 JDBC 驅動程序支持。WebLogic Server 使用 值為 值為 MBean 特性 （不適用於應用程序模塊）: 最小值: |
| Ignore In-Use Connections 忽略正在使用的連接 |
即便仍在使用從緩沖池獲取的連接，也能夠將數據源關閉。 MBean 特性 （不適用於應用程序模塊）: |
| PinnedToThread 是一個能夠改善性能的選項，它啟用執行線程以保持已進入緩沖池的數據庫連接，即使在應用程序關閉邏輯連接之后。 啟用 PinnedToThread 后，WebLogic Server 將在應用程序首次使用某個執行線程保留連接時把連接緩沖池中的一個數據庫連接固定到此線程。當應用程序使用完此連接並調用 connection.close()（此方法在其他情況下將把連接返回到連接緩沖池）時，WebLogic Server 將把該連接保留給執行線程，而不會將其返回連接緩沖池。當此后某個應用程序使用相同的執行線程請求連接時，WebLogic Server 將提供此線程已保留的這個連接。 使用 PinnedToThread，當多個線程嘗試同時保留一個連接時，連接緩沖池上不會發生鎖定沖突，對於試圖在有限個數的數據庫連接中保留同一個連接的線程，也沒有沖突。 如果應用程序使用相同的執行線程同時保留連接緩沖池中的多個連接，WebLogic Server 將創建附加的數據庫連接並同樣將它們固定到此線程。 MBean 特性 （不適用於應用程序模塊）: |
|
| Remove Infected Connections Enabled 已啟用刪除受影響的連接 |
指定在應用程序使用底層供應商連接對象之后是否從連接緩沖池中刪除連接。 如果禁止刪除已占用的連接，必須確保該數據庫連接適合被其他應用程序重復使用。 設置為 設置為 MBean 特性 （不適用於應用程序模塊）: |