Connection String Options
The connection string 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 string for this provider. Click the links for further details.
For more information on connecting, 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 |
| BatchSize | The maximum size of each batch operation to submit. |
| CommandTimeout | The timeout before the command is aborted and the transaction rolled back. |
| ConnectionLifeTime | The maximum lifetime of a connection in seconds. Once the time has elapsed, the connection object is disposed. |
| 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). |
| PoolIdleTimeout | The allowed idle time for a connection before it is closed. |
| PoolMaxSize | The maximum connections in the pool. |
| PoolMinSize | The minimum number of connections in the pool. |
| PoolWaitTime | The max seconds to wait for an available connection. |
| 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). |
| RTK | The runtime key used for licensing. |
| 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. |
| UseConnectionPooling | This property enables connection pooling. |
| 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. |