Connection Properties
The connection properties are the various options that can be used to establish a connection. This section provides a complete list of the options you can configure in the connection settings for this provider. Click the links for further details.
For more information on establishing a connection, see Establishing a Connection.
Property | Description |
AuthenticationString | AuthenticationString enables support for mechanisms that require additional authentication information. |
DataSource | The Teradata server name or, equivalently, the DBC Name or TDPID. |
AuthScheme | Specifies the Logon Mechanism, which determines the connection's authentication and encryption capabilities. |
User | The Teradata user account used to authenticate. |
Password | The password used to authenticate the user. |
Database | The database selected as the default database when a Teradata connection is opened. |
Port | Connects to the Teradata Database on the TCP/IP port specified. The default Teradata Database port is 1025. |
Account | Specifies an account string to override the default account string defined for the Teradata Database user. |
AccountString | Identifies an individual user account and is associated with a specific User Id. |
IntegatedSecurity | Set this to true to use Single Sign On. |
Property | Description |
ConnectionTimeout | Specifies the time in seconds to wait for a Teradata session to be opened or established. |
ConnectionPooling | Enables or disables connection pooling. |
ConnectionPoolingTimeout | Specifies the time a connection may stay idle inside the pool. |
ConnectMaxRetryCount | The maximum number of reattempts before the connection will fail. |
Property | Description |
FirewallType | The protocol used by a proxy-based firewall. |
FirewallServer | The name or IP address of a proxy-based firewall. |
FirewallPort | The TCP port for a proxy-based firewall. |
FirewallUser | The user name to use to authenticate with a proxy-based firewall. |
FirewallPassword | A password used to authenticate to a proxy-based firewall. |
Property | Description |
Logfile | A filepath which designates the name and location of the log file. |
Verbosity | The verbosity level that determines the amount of detail included in the log file. |
LogModules | Core modules to be included in the log file. |
MaxLogFileSize | A string specifying the maximum size in bytes for a log file (for example, 10 MB). |
MaxLogFileCount | A string specifying the maximum file count of log files. |
Property | Description |
Location | A path to the directory that contains the schema files defining tables, views, and stored procedures. |
BrowsableSchemas | This property restricts the schemas reported to a subset of the available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC. |
Tables | This property restricts the tables reported to a subset of the available tables. For example, Tables=TableA,TableB,TableC. |
Views | Restricts the views reported to a subset of the available tables. For example, Views=ViewA,ViewB,ViewC. |
Property | Description |
AutoCache | Automatically caches the results of SELECT queries into a cache database specified by either CacheLocation or both of CacheConnection and CacheProvider . |
CacheProvider | The name of the provider to be used to cache data. |
CacheConnection | The connection string for the cache database. This property is always used in conjunction with CacheProvider . Setting both properties will override the value set for CacheLocation for caching data. |
CacheLocation | Specifies the path to the cache when caching to a file. |
CacheTolerance | The tolerance for stale data in the cache specified in seconds when using AutoCache . |
Offline | Use offline mode to get the data from the cache instead of the live source. |
CacheMetadata | This property determines whether or not to cache the table metadata to a file store. |
Property | Description |
CommandTimeout | The timeout before the command is aborted and the transaction rolled back. |
DataEncryption | Enables or disables session-level encryption. Default: false. |
DataIntegrity | Enables or disables session-level integrity. Default: false. |
DataSourceDnsEntries | The number of entries defined in DNS for the DataSource . |
DisableAutoCommitInBatch | Specifies whether or not disable the autocommit when executing the batch operation. |
EnableDateTimeOffset | Enables and disables the mapping of TIMESTAMP WITH ZONE to DateTimeOffset. Default: true. |
EnableTdDateTime | Enables and disables mapping date-time types to provider-specific types. Default: true. |
EnableTdDecimal | Enables and disables mapping of Decimal(18) to the TdDecimal provider-specific type. |
HttpsPort | Connects to the database on the Transmission Control Protocol/Internet Protocol (TCP/IP) port specified for HTTPS/TLS connections. |
MaxDecimalPrecision | Used to set the maximum precision of a decimal that can be retrieved from Teradata. |
MaxRows | Limits the number of rows returned when no aggregation or GROUP BY is used in the query. This takes precedence over LIMIT clauses. |
NodeDownTimeout | (Obsolete) the number of seconds that must elapse before a connection attempt is made to a node previously marked as unavailable. |
Other | These hidden properties are used only in specific use cases. |
PersistSecurityInfo | Set this to true to persist sensitive authentication information (false by default). |
ProfileName | Specifies the profile name to access supported properties from the application configuration file. |
QueryBand | Gets or sets the Query Bands that are to be defined at the connection level. |
QueryPassthrough | This option passes the query to the Teradata server as is. |
ReadAhead | Enables additional buffering of results, while the current buffer is consumed by an application. True by default. |
Readonly | You can use this property to enforce read-only access to Teradata from the provider. |
Recovery | Sets Recoverable Network Protocol (RNP) and Redrive properties used during a network error or database failure. |
RecoveryCommandTimeoutOverride | Enables a RecoveryTimeout value to be supplied during reconnection for commands that contain a finite CommandTimeout . True by default. |
RecoveryIntervalFactor | This represents the adjustment in the recovery interval period from the preceding interval period. The factor is an additive factor in seconds (2 by default). |
RecoveryMaximumInterval | This represents the maximum interval time in seconds to wait while attempting to reconnect to the database. |
RecoveryStartInterval | The starting time interval (in seconds) after which an attempt to retry a reconnection is performed. |
RecoveryTimeout | Recovery timeout in seconds used to re-establish a connection. |
ResponseBufferSize | Gets and sets the initial size of the internal communication data buffers. |
RestrictToDefaultDatabase | Set this to true to restrict schema queries invoking GetSchema to the default database (false by default). |
SessionCharacterSet | Gets or sets the character encoding (Text.Encoding) for the connection. |
SessionMode | Specifies the session mode on a Teradata Database V2R2.0 or later system. The selected mode applies for the duration of the session. |
SslCa | Specifies the file name of a PEM file that contains Certificate Authority (CA) certificates for use with SSLMODE=VERIFY-CA or VERIFY-FULL. |
SslCaPath | Specifies a directory of PEM files that contain Certificate Authority (CA) certificates for use with SSLMODE=VERIFY-CA or VERIFY-FULL. |
SslMode | Specifies the mode for connections to the database. |
SslProtocol | Specifies the TLS protocol for HTTPS/TLS connections. |
Timeout | The value in seconds until the timeout error is thrown, canceling the operation. |
UpperCaseIdentifiers | This property reports all identifiers in uppercase. This is the default for Oracle databases and thus allows better integration with Oracle tools such as the Oracle Database Gateway. |
UseEnhancedSchemaTable | Gets or sets a Boolean value that indicates whether the GetSchemaTable method returns additional result set metadata (default: true). |
UseXViews | Specifies which Data Dictionary views should be queried to return result sets from DatabaseMetaData methods. |