Advanced Tab
The following table and the sections below lists and explains the connection properties that are in the Advanced Tab of the New Data Source Window.
|
The degree to which transactions are isolated from data modifications made by other transactions. |
|
|
Lets you specify property-value pairs to pass to the data source. |
|
|
Minimum number of connections in the pool even when the pool is inactive. |
|
|
Maximum number of connections (both active and idle) allowed for the data source. When the maximum is reached, new requests must wait until a connection is available. |
|
|
Number of seconds that a connection can remain idle without being dropped from the pool when there are more than the minimum number of connections. |
|
|
The number of minutes that a connection that was returned to the pool persists if there are more open connections than the minimum pool size. |
|
|
A procedure that returns a valid SQL statement that can be used to initialize the connection. |
|
|
Time that a connection doing a checkout can remain idle without being dropped. |
|
|
A data-source-specific query that the TDV query engine sends to see if the data source connection is valid. This query is executed every time a connection is checked out from the pool. Enter a query that returns quickly. |
|
|
Select or clear the check box. If cleared, specify an Execution timeout value in seconds |
|
|
The number of seconds an execution query on the data source can run before being canceled. |
|
|
Execute SELECTs in separate transactions from INSERTs and UPDATEs |
Lets a SELECT statement be executed using a new connection from the connection pool, and committed immediately after completion. INSERT and UPDATE, statements are executed using the same connection as part of the transaction. |
|
Multiple Parameters that can be set to control String manipulation by the data source. |
Transaction Isolation
The degree to which transactions are isolated from data modifications made by other transactions.
Data Type
string
Default Value
NONE
Remarks
Valid values are:
| • | Read Uncommitted—Dirty reads, nonrepeatable reads, and phantom reads can occur. |
| • | Read Committed—Nonrepeatable reads and phantom reads can occur. |
| • | Repeatable Read—Only phantom reads can occur. |
| • | Serializable—Dirty reads, nonrepeatable reads, and phantom reads are prevented. |
| • | None |
Connection Attributes
Lets you specify property-value pairs to pass to the data source. For example:
bootPassword=key attribute
collation=collation attribute
dataEncryption=true attribute
drop=true attribute
encryptionKey=key attribute
encryptionProvider=providerName attribute
encryptionAlgorithm=algorithm attribute
failover=true attribute
Data Type
String
Default Value
“”
Connection Pool Maximum Size
Maximum number of connections (both active and idle) allowed for the data source. When the maximum is reached, new requests must wait until a connection is available.
Data Type
Numeric
Default Value
100
Remarks
If the maximum number of connections is in use when a request comes in (even with pass-through authentication), the new request is blocked and queued until a connection is available or the Connection Pool Idle Timeout is reached.
If no connection was made available within the specified timeout, a check is made for an available connection by the same user. If none is available, the least recently used connection for another user is dropped and a new connection is opened.
Studio reuses pooled connections if they continue to be valid after changes (such as connection name), but JDBC requests are forced to use new connections if any part of the data source connection configuration has changed.
Connection Pool Minimum Size
Minimum number of connections in the pool even when the pool is inactive.
Data Type
Numeric
Default Value
0
Remarks
When a connection has been idle, a validation query is used to verify whether an open connection is still valid just prior to submission of a request. If the connection is invalid, the connection is discarded and another is used.
Connection Pool Idle Timeout
Number of seconds that a connection can remain idle without being dropped from the pool when there are more than the minimum number of connections.
Data Type
Numeric
Default Value
30
Maximum Connection Lifetime
The number of minutes that a connection that was returned to the pool persists if there are more open connections than the minimum pool size.
Data Type
Numeric
Default Value
30
Remarks
The duration is calculated from connection creation. Default value is 60 minutes. Set a smaller value if the pool is likely to run out of connections. Be sure to add a validation query. Set a larger value if you want the connections to be held for a longer period. Set a value of 0 to keep connections alive indefinitely.
Connection Validation Query
A data-source-specific query that the TDV query engine sends to see if the data source connection is valid. This query is executed every time a connection is checked out from the pool. Enter a query that returns quickly.
Data Type
string
Default Value
""
Remarks
If this query returns a non-error result, the data source connection is considered valid. If this query fails, the connection is discarded and a new connection is checked out from the available pool.
No one SELECT statement works with all data sources. To verify that TDV is running and that it can connect to the data source, devise a query against a published table from that data source.
Data source driver doesn’t support query timeout
Select or clear the check box. If cleared, specify an Execution timeout value in seconds.
Data Type
Bool
Default Value
True
Remarks
None
Execution Timeout
The number of seconds an execution query on the data source can run before being canceled.
Data Type
Numeric
Default Value
0
Remarks
None
Execute SELECTs in separate transactions from INSERTs and UPDATEs
Lets a SELECT statement be executed using a new connection from the connection pool, and committed immediately after completion. INSERT and UPDATE, statements are executed using the same connection as part of the transaction.
Data Type
Bool
Default Value
True
Remarks
None
Connection Checkout Procedure
A procedure that returns a valid SQL statement that can be used to initialize the connection.
Data Type
string
Default Value
""
Remarks
The signature of the initialization procedure should be:
(IN ds_name VARCHAR, OUT sqlText VARCHAR)
Give the full path to the procedure in the Connection Check-out Procedure box.
Connection Checkout Timeout
Time that a connection doing a checkout can remain idle without being dropped.
Data Type
Numeric
Default Value
45
Remarks
None
String Comparison Parameters
Following flags can be used to manage the rules of the string comparison.
|
Case sensitivity mismatch between TDV and data source can be ignored |
Check to ignore case mismatches. |
|
Ignore trailing space mismatches between TDV and the data source |
Check to ignore trailing spaces. |
|
Honor trailing spaces for string comparison |
Check to honor trailing spaces. |
|
Case insensitive string comparison |
Ignore case. |