View This JDBC Connection Pool Params
/management/weblogic/{version}/serverConfig/partitions/{name}/resourceGroups/{name}/JDBCSystemResources/{name}/JDBCResource/JDBCConnectionPoolParams
View this JDBC connection pool params.
Request
-
name: string
The name property of the instance in the collection.
-
version: string
The version of the WebLogic REST interface.
-
excludeFields(optional): string
The 'excludeFields' query parameter is used to restrict which fields are returned in the response. It is a comma separated list of field names. If present, only fields whose name is not on the list will be returned. If not present, all fields are returned (unless the 'fields' query parameter is specified). Note: 'fields' must not be specified if 'excludeFields' is specified.
-
excludeLinks(optional): string
The 'excludeLinks' query parameter is used to restrict which links are returned in the response. It is a comma separated list of link relationship names. If present, only links whose relationship name is not on the list will be returned. If not present, all links are returned (unless the 'links' query parameter is specified). Note: 'links' must not be specified if 'excludeLinks' is specified.
-
fields(optional): string
The 'fields' query parameter is used to restrict which fields are returned in the response. It is a comma separated list of field names. If present, only fields with matching names are returned. If not present, all fields are returned (unless the 'excludeFields' query parameter is specified). Note: 'excludeFields' must not be specified if 'fields' is specified.
-
links(optional): string
The 'links' query parameter is used to restrict which links are returned in the response. It is a comma separated list of link relationship names. If present, only links with matching relationship names are returned. If not present, all links are returned (unless the 'excludeLinks' query parameter is specified). Note: 'excludeLinks' must not be specified if 'links' is specified.
-
Admin: basic
Type:
basic
Description:A user in the Admin security role.
-
Deployer: basic
Type:
basic
Description:A user in the Deployer security role.
-
Monitor: basic
Type:
basic
Description:A user in the Monitor security role.
-
Operator: basic
Type:
basic
Description:A user in the Operator security role.
Response
- application/json
200 Response
Returns this JDBC connection pool params.
object
-
connectionCreationRetryFrequencySeconds(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:0
The number of seconds between attempts to establish connections to the database.
If you do not set this value, data source creation fails if the database is unavailable. If set and if the database is unavailable when the data source is created, WebLogic Server will attempt to create connections in the pool again after the number of seconds you specify, and will continue to attempt to create the connections until it succeeds.
When set to
, connection retry is disabled.
-
connectionHarvestMaxCount(optional):
integer(int32)
Minimum Value:
1
Default Value:1
The maximum number of connections that may be harvested when the connection harvesting occurs. The range of valid values is 1 to MaxCapacity.
-
connectionHarvestTriggerCount(optional):
integer(int32)
Minimum Value:
-1
Default Value:-1
Specifies the number of available connections (trigger value) used to determine when connection harvesting occurs.
Harvesting occurs when the number of available connections is below the trigger value for a connection pool.
The range of valid values is -1 to
MaxCapacity
Default value is
-1
Setting the value to
-1
disables connection harvesting.
-
connectionLabelingCallback(optional):
string
The class name of the connection labeling callback. This is automatically passed to registerConnectionLabelingCallback when the datasource is created. The class must implement
oracle.ucp.ConnectionLabelingCallback
-
connectionReserveTimeoutSeconds(optional):
integer(int32)
Minimum Value:
-1
Maximum Value:2147483647
Default Value:10
The number of seconds after which a call to reserve a connection from the connection pool will timeout.
When set to
, a call will never timeout.
When set to
-1
, a call will timeout immediately. -
countOfRefreshFailuresTillDisable(optional):
integer(int32)
Minimum Value:
0
Default Value:2
Specifies the number of reconnect failures allowed before WebLogic Server disables a connection pool to minimize the delay in handling the connection request caused by a database failure. Zero means it is disabled.
-
countOfTestFailuresTillFlush(optional):
integer(int32)
Minimum Value:
0
Default Value:2
Specifies the number of test failures allowed before WebLogic Server closes all unused connections in a connection pool to minimize the delay caused by further database testing. Zero means it is disabled.
-
credentialMappingEnabled(optional):
boolean
Default Value:
false
Enables Set Client ID on connection for the data source. When an application requests a database connection, WebLogic Server sets a light-weight client ID on the database connection.
By default, it uses the credential mapping to map WebLogic Server user IDs to database user IDs. However, if use-database-credentials is set to true, then the credential mapping is not done and the ID is used directly as a database user ID.
It is currently supported for IBM DB2 driver and Oracle thin driver. Support for this feature will be dropped in a future Oracle thin driver release. Oracle recommends using proxy authentication instead of this feature.
-
driverInterceptor(optional):
string
Specifies the absolute name of the application class used to intercept method calls to the JDBC driver. The application specified must implement the weblogic.jdbc.extensions.DriverInterceptor interface.
Weblogic Server will invoke the preInvokeCallback(), postInvokeExceptionCallback(), and postInvokeCallback() methods of the registered application before and after invoking any method inside the JDBC driver. You can use this feature to profile JDBC driver usage and monitor:
Methods being executed
Any exceptions thrown
Time spent inside the driver executing methods
-
fatalErrorCodes(optional):
string
Specifies a comma-separated list of error codes that are treated as fatal errors. These errors include deployment errors that cause a server to fail to boot and connection errors that prevent a connection from being put back in the connection pool.
This optional attribute is used to define fatal error codes, that when specified as the exception code within a
SQLException
(retrieved bysqlException.getErrorCode()
), indicate that a fatal error has occurred and the connection is no longer usable. For Oracle databases the following fatal error codes are predefined within WLS and do not need to be placed in the configuration file:3113: "end-of-file on communication channel"
3114: "not connected to ORACLE"
1033: "ORACLE initialization or shutdown in progress"
1034: "ORACLE not available"
1089: "immediate shutdown in progress - no operations are permitted"
1090: "shutdown in progress - connection is not permitted"
17002: "I/O exception"
-
highestNumWaiters(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:2147483647
The maximum number of connection requests that can concurrently block threads while waiting to reserve a connection from the data source's connection pool.
-
identityBasedConnectionPoolingEnabled(optional):
boolean
Default Value:
false
Enables identity-based-connection-pooling for the data source. When an application requests a database connection, WebLogic Server picks or creates a physical connection with requested DBMS identity based on a map of WebLogic user IDs and database IDs.
You must also specify the map of WebLogic Server user IDs to database user IDs (credential mapping).
-
ignoreInUseConnectionsEnabled(optional):
boolean
Default Value:
true
Enables the data source to be shutdown even if connections obtained from the pool are still in use.
-
inactiveConnectionTimeoutSeconds(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:0
The number of inactive seconds on a reserved connection before WebLogic Server reclaims the connection and releases it back into the connection pool.
You can use the Inactive Connection Timeout feature to reclaim leaked connections - connections that were not explicitly closed by the application. Note that this feature is not intended to be used in place of properly closing connections.
When set to
, the feature is disabled.
-
initialCapacity(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:1
The number of physical connections to create when creating the connection pool in the data source. If unable to create this number of connections, creation of the data source will fail.
-
initSql(optional):
string
SQL statement to execute that will initialize newly created physical database connections. Start the statement with SQL followed by a space.
If the Init SQL value begins with
"SQL "
, then the rest of the string following that leading token will be taken as a literal SQL statement that will be used to initialize database connections. If the Init SQL value does not begin with "SQL ", the value will be treated as the name of a table and the following SQL statement will be used to initialize connections:"select count(*) from InitSQL"
The table
InitSQL
must exist and be accessible to the database user for the connection. Most database servers optimize this SQL to avoid a table scan, but it is still a good idea to setInitSQL
to the name of a table that is known to have few rows, or even no rows. -
JDBCXADebugLevel(optional):
integer(int32)
Minimum Value:
0
Maximum Value:100
Default Value:10
Specifies level of JDBC debugging for XA drivers, where larger values in the range provide more debugging information.
-
loginDelaySeconds(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:0
The number of seconds to delay before creating each physical database connection. This delay supports database servers that cannot handle multiple connection requests in rapid succession.
The delay takes place both during initial data source creation and during the lifetime of the data source whenever a physical database connection is created.
-
maxCapacity(optional):
integer(int32)
Minimum Value:
1
Maximum Value:2147483647
Default Value:15
The maximum number of physical connections that this connection pool can contain.
-
minCapacity(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:1
The minimum number of physical connections that this connection pool can contain after it is initialized.
Default: InitialCapacity
Used only for connection pool shrinking calculations.
For compatibility,
InitialCapacity
is used ifMinCapacity
is not configured.Once a data source has gone through a suspend/resume, the larger value of either
MinCapacity
orInitialCapacity
is used.
-
pinnedToThread(optional):
boolean
Default Value:
false
Enables an option to improve performance by enabling execute threads to keep a pooled database connection even after the application closes the logical connection.
When enabled:
WebLogic Server pins a database connection from the connection pool to an execution thread the first time an application uses the thread to reserve a connection. When the application finishes using the connection and calls
connection.close()
, WebLogic Server keeps the connection with the execute thread and does not return it to the connection pool. When an application subsequently requests a connection using the same execute thread, WebLogic Server provides the connection already reserved by the thread.There is no locking contention on the connection pool that occurs when multiple threads attempt to reserve a connection at the same time. There is no contention for threads that attempt to reserve the same connection from a limited number of database connections.
If an application concurrently reserves more than one connection from the connection pool using the same execute thread, WebLogic Server creates additional database connections and pins them to the thread.
The maximum capacity of the connection pool (maximum number of database connections created in the connection pool) becomes the number of execute threads used to request a connection multiplied by the number of concurrent connections each thread reserves. This may exceed the
Maximum Capacity
specified for the connection pool. You may need to consider this larger number of connections in your system design and ensure that your database allows for additional associated resources. If your system cannot handle the additional resource requirements or if you see database resource errors after enablingPinnedToThread
, Oracle recommends not usingPinnedToThread
. See Using Pinned-To-Thread Property to Increase Performance
-
profileConnectionLeakTimeoutSeconds(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:0
The number of seconds that a JDBC connection needs to be held by an application before triggering a connection leak diagnostic profiling record.
When set to
, the timeout is disabled. This attribute only applies when the connection leak diagnostic profiling option is enabled.
-
profileHarvestFrequencySeconds(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:300
The number of seconds between when WebLogic Server harvests profile data.
When set to
, harvesting of data is disabled.
-
profileType(optional):
integer(int32)
Default Value:
0
Specifies that type of profile data to be collected for the JDBC subsystem.
You can specify combinations of the following profile types:
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_CONN_USAGE - Profile threads currently using connections from the pool of connections in the data source.
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_CONN_RESV_WAIT - Profile threads currently waiting to reserve a connection from the data source.
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_CONN_LEAK - Profile threads that have reserved a connection from the data source and the connection leaked (was not properly returned to the pool of connections).
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_CONN_RESV_FAIL - Profile threads that attempt to reserve a connection from the data source but fail.
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_STMT_CACHE_ENTRY - Profile prepared and callable statements added to the statement cache, and profile the threads that originated the cached statements.
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_STMT_USAGE - Profile threads currently executing SQL statements from the statement cache.
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_CONN_LAST_USAGE - Profile the previous thread that last used the connection. This information is useful when debugging problems with connections infected with pending transactions that cause subsequent XA operations on the connections to fail.
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_CONN_MT_USAGE - Profile threads that erroneously use a connection previously obtained by a different thread.
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_CONN_UNWRAP_USAGE - Profile threads that have obtained the JDBC delegate object by invoking unwrap or weblogic.common.wrapper.Wrapper.getVendorObj.
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_CONN_LOCALTX_LEAK - Profile threads that close JDBC connections that have an active local database transaction.
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_NONE - Disable profiling for the data source.
weblogic.jdbc.common.internal.JDBCConstants.PROFILE_TYPE_ALL - Enable all profile types for the data source.
-
removeInfectedConnections(optional):
boolean
Default Value:
true
Specifies whether a connection will be removed from the connection pool after the application uses the underlying vendor connection object.
If you disable removing infected connections, you must make sure that the database connection is suitable for reuse by other applications.
When set to
true
(the default), the physical connection is not returned to the connection pool after the application closes the logical connection. Instead, the physical connection is closed and recreated.When set to
false
, when the application closes the logical connection, the physical connection is returned to the connection pool and can be reused by the application or by another application. -
secondsToTrustAnIdlePoolConnection(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:10
The number of seconds within a connection use that WebLogic Server trusts that the connection is still viable and will skip the connection test, either before delivering it to an application or during the periodic connection testing process.
This option is an optimization that minimizes the performance impact of connection testing, especially during heavy traffic.
-
shrinkFrequencySeconds(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:900
The number of seconds to wait before shrinking a connection pool that has incrementally increased to meet demand.
When set to
, shrinking is disabled.
-
statementCacheSize(optional):
integer(int32)
Minimum Value:
0
Maximum Value:1024
Default Value:10
The number of prepared and callable statements stored in the cache. (This may increase server performance.)
WebLogic Server can reuse statements in the cache without reloading the statements, which can increase server performance. Each connection in the connection pool has its own cache of statements.
Setting the size of the statement cache to 0 turns off statement caching.
-
statementCacheType(optional):
string
Default Value:
LRU
Allowed Values:[ "LRU", "FIXED" ]
The algorithm used for maintaining the prepared statements stored in the statement cache.
Options are:
LRU - when a new prepared or callable statement is used, the least recently used statement is replaced in the cache.
FIXED - the first fixed number of prepared and callable statements are cached.
-
statementTimeout(optional):
integer(int32)
Minimum Value:
-1
Maximum Value:2147483647
Default Value:-1
The time after which a statement currently being executed will time out.
StatementTimeout relies on underlying JDBC driver support. WebLogic Server passes the time specified to the JDBC driver using the
java.sql.Statement.setQueryTimeout()
method. If your JDBC driver does not support this method, it may throw an exception and the timeout value is ignored.A value of
-1
disables this feature.A value of
means that statements will not time out.
-
testConnectionsOnReserve(optional):
boolean
Default Value:
false
Enables WebLogic Server to test a connection before giving it to a client. (Requires that you specify a Test Table Name.)
The test adds a small delay in serving the client's request for a connection from the pool, but ensures that the client receives a viable connection.
-
testFrequencySeconds(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:120
The number of seconds a WebLogic Server instance waits between attempts when testing unused connections. (Requires that you specify a Test Table Name.) Connections that fail the test are closed and reopened to re-establish a valid physical connection. If the test fails again, the connection is closed.
In the context of multi data sources, this attribute controls the frequency at which WebLogic Server checks the health of data sources it had previously marked as unhealthy.
When set to
, the feature is disabled.
-
testTableName(optional):
string
The name of the database table to use when testing physical database connections. This name is required when you specify a Test Frequency and enable Test Reserved Connections.
The default SQL code used to test a connection is
select count(*) from TestTableName
Most database servers optimize this SQL to avoid a table scan, but it is still a good idea to set the Test Table Name to the name of a table that is known to have few rows, or even no rows.
If the Test Table Name begins with
SQL
, then the rest of the string following that leading token will be taken as a literal SQL statement that will be used to test connections instead of the standard query. For example:SQL BEGIN; Null; END;
For an Oracle database, you can reduce the overhead of connection testing by setting Test Table Name to
SQL PINGDATABASE
which uses thepingDatabase()
method to test the Oracle connection. For any JDBC 4.0 database, it is possible to use "SQL ISVALID" to use theisValid()
method on the connection. -
wrapJdbc(optional):
boolean
Default Value:
true
By default, SQL objects for
CallableStatement
,PreparedStatement
,ResultSet
,Statement
, andDatabaseMetaData
are wrapped with a WebLogic wrapper. Wrapping allows features like debugging and connection usage to be performed by the server.When
false
, wrapping is disabled. This improves performance, in some cases significantly, and allows for the application to use the native driver objects directly. A value offalse
also disables data type wrapping. -
wrapTypes(optional):
boolean
Default Value:
true
By default, data type objects for Array, Blob, Clob, NClob, Ref, SQLXML, and Struct, plus ParameterMetaData and ResultSetMetaData objects are wrapped with a WebLogic wrapper. This allows for features like debugging and connection usage to be done by the server.
The wrapping can be turned off by setting this value to false. This improves performance, in some cases significantly, and allows for the application to use the native driver objects directly.