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.
|
A template for generating a URL to connect to the physical data source. |
|||||||||||||
|
The URL string generated from the connection URL pattern with the connection information you provide. |
|||||||||||||
|
Lets you specify property-value pairs to pass to the JDBC data source |
|||||||||||||
|
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. |
|||||||||||||
|
Minimum number of connections in the pool even when the pool is inactive. |
|||||||||||||
|
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 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. |
|||||||||||||
|
The number of seconds an execution query on the data source can run before being canceled. |
|||||||||||||
|
Lets a SELECT statement be executed using a new connection from the connection pool, and committed immediately after completion. INSERT, UPDATE, and DELETE statements are executed using the same connection as part of the transaction. |
|||||||||||||
|
A procedure that returns a valid SQL statement that can be used to initialize the connection. |
|||||||||||||
|
Check only if this data source supports very large predicates and very large cardinalities for star schema semijoins. |
|||||||||||||
|
See the documentation for semijoins and the TDV Administration Guide for more information. |
|||||||||||||
|
Sets the minimum target-to-source ratio of cardinality for semijoins. Refer to the TDV Administration Guide for more information. |
|||||||||||||
|
See the documentation for semijoins and the TDV Administration Guide for more information. |
|||||||||||||
| Enable Native Data Loading |
Lets the data source use its proprietary functionality to optimize performance. |
||||||||||||
|
TDV does not use the SORT MERGE join algorithm if any data source involved in the join is marked Collation Sensitive. |
|||||||||||||
|
Works with the Massively Parallel Processing engine configuration parameters to control the amount of parallelization for the queries for a particular data source. |
|||||||||||||
|
Returns data only for rows containing information on objects that the requesting user owns, created, has privileges on, or has been granted access through a current or nested role. |
|||||||||||||
|
Turns the query banding feature on (At Session Level) or off (Off). Stores query context information in the Teradata session table so it can be recovered after a system reset. Query banding takes effect when the data source is next used. Connection pooling has no effect on query band data. |
|||||||||||||
|
Click QueryBand Properties on the right to open a dialog box in which to specify property-value pairs to store in the session table. Four properties are available by default. For the first three, if the default value (including brackets) appears alone in the value field, it is replaced with the actual value at run time.
TDV administrator can click Add property to add custom name-value pairs. |
|||||||||||||
|
Indicates whether the physical data source might be used as a source of shipped tables to another data ship enabled data source |
|||||||||||||
|
Indicates whether the physical data source might be used to receive shipped tables from another data ship enabled data source. |
|||||||||||||
|
TDV uses Explain Plan to arrive at a numeric estimate of the cost of shipping data from a node to the Data Virtualizer. When the cost of shipping a federated query node falls between the limits of the Lowerbound and Upperbound, it is considered eligible for shipment so that it can be processed locally. |
|||||||||||||
|
A relative path to set the location of the temp tables on the data source. It is the name of a schema in the data source. |
|||||||||||||
|
A character string addition to temporary table names so that they are recognized if they are needed. |
|||||||||||||
|
Use the FastLoad or FastExport utility to speed up queries. Cardinality information determines whether to use Fastpath or JDBC default loading for a given query. |
|||||||||||||
|
The number of FastExport sessions to use. |
|||||||||||||
|
The number of FastLoad sessions to use. |
Connection URL Pattern
A template for generating a URL to connect to the physical data source.
Data Type
string
Default Value
jdbc:<DATA SOURCE>//<HOST>:<PORT>/<DATABASE_NAME>
Remarks
TDV does not validate modifications at the time of configuration. The data source adapter might not validate changes.
Connection URL String
The URL string generated from the connection URL pattern with the connection information you provide.
Data Type
string
Default Value
“”
Remarks
This string is used by the JDBC adapter to connect to the physical data source. This field cannot be edited. For details, see the section “Connecting through JDBC Adapters” in the TDV Administration Guide.
JDBC Connection Properties
Lets you specify property-value pairs to pass to the JDBC data source.
Data Type
string
Default Value
“”
Remarks
Click to add custom connection properties for any JDBC data source. Commonly used properties are populated with default values. Use the Add Argument button to specify other properties and values.
TDV does not validate property names. Some data source adapters ignore invalid property names or values; others return an error.
The driver properties specify connection timeout settings required by specific drivers. To avoid leaving connections open indefinitely, specify properties explicitly for your data source.
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.
Enable Native Data Loading
Lets the data source use its proprietary functionality to optimize performance.
Data Type
Bool
Default Value
True
Remarks
See the User Guide, Chapter About Data Source Native Load Performance Options” for more details,.
Collation Sensitive
TDV does not use the SORT MERGE join algorithm if any data source involved in the join is marked Collation Sensitive.
Data Type
Bool
Default Value
False
Remarks
None
Concurrent Request Limit
Works with the Massively Parallel Processing engine configuration parameters to control the amount of parallelization for the queries for a particular data source.
Data Type
Numeric
Default Value
0
Remarks
None
Use X Views
Returns data only for rows containing information on objects that the requesting user owns, created, has privileges on, or has been granted access through a current or nested role.
Data type
Bool
Default Value
False
Remarks
None
Query Banding
Turns the query banding feature on (At Session Level) or off (Off). Stores query context information in the Teradata session table so it can be recovered after a system reset. Query banding takes effect when the data source is next used.
Connection pooling has no effect on query band data.
Data Type
String
Default Value
Off
Remarks
None
QueryBand Properties
Click QueryBand Properties on the right to open a dialog box in which to specify property-value pairs to store in the session table.
Four properties are available by default. For the first three, if the default value (including brackets) appears alone in the value field, it is replaced with the actual value at run time.
| • | TDV_USER. ID of the TDV user, application or report that originated the request from a middle-tiered application. The default value is <TDV_USER>. |
| • | DOMAIN. The default value is <DOMAIN>. |
| • | SESSION_NAME. The default value is <SESSION_NAME>. |
| • | SYS. The default value is TDV. |
TDV administrator can click Add property to add custom name-value pairs.
Data Type
String
Default Value
""
Remarks
None
Is dataship source
Indicates whether the physical data source might be used as a source of shipped tables to another data ship enabled data source.
Data Type
Bool
Default Value
False
Remarks
None
Is dataship target
Indicates whether the physical data source might be used to receive shipped tables from another data ship enabled data source.
Data Type
Bool
Default Value
False
Remarks
To make changes in this field, Is dataship source must be enabled.
Lower bound/Upper bound for dataship
TDV uses Explain Plan to arrive at a numeric estimate of the cost of shipping data from a node to the Data Virtualizer. When the cost of shipping a federated query node falls between the limits of the Lowerbound and Upperbound, it is considered eligible for shipment so that it can be processed locally.
Data Type
Numeric
Default Value
Lower bound - 50000
Upper bound - 5000000
Remarks
To make changes in this field, Is dataship source must be enabled.
Schema Path for Temp Tables
A relative path to set the location of the temp tables on the data source. It is the name of a schema in the data source.
Data Type
String
Default Value
""
Remarks
To make changes in this field, Is dataship target must be enabled.
Temp Table Prefix
A character string addition to temporary table names so that they are recognized if they are needed.
Data Type
String
Default Value
T
Remarks
To make changes in this field, Is dataship target must be enabled.
Enable FastLoad/FastExport for large tables
Use the FastLoad or FastExport utility to speed up queries. Cardinality information determines whether to use Fastpath or JDBC default loading for a given query.
Data Type
Bool
Default Value
False
Remarks
None
FastExport Session Count
The number of FastExport sessions to use.
Data Type
Numeric
Default Value
4
Remarks
To make changes in this field, Enable FastLoad/FastExport for large tables field must be enabled.
FastLoad Session Count
The number of FastLoad sessions to use.
Data Type
Numeric
Default Value
4
Remarks
To make changes in this field, Enable FastLoad/FastExport for large tables field must be enabled.
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 Independently
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.
Max Source Side Cardinality for Semi Join
See the documentation for semijoins and the TDV Administration Guide for more information.
Data Type
Numeric
Default Value
""
Remarks
None
Max Source Side of Semi Join To Use OR Syntax
See the documentation for semijoins and the TDV Administration Guide for more information.
Data Type
Numeric
Default Value
2147483647
Remarks
None
Min Target to Source Ratio for Semi Join
Sets a minimum ratio to trigger use of semi join optimization.
Data Type
Numeric
Default Value
""
Remarks
None
Supports Star Schema
Check only if this data source supports very large predicates and very large cardinalities for star schema semijoins.
Data Type
Bool
Default Value
False
Remarks
Refer to the section Star Schema Semijoin in the User Guide, for more information.