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 | Specifies the authenticating user's user ID. |
| Password | Specifies the authenticating user's password. |
| 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 | Specifies the protocol the provider uses to tunnel traffic through a proxy-based firewall. |
| FirewallServer | Identifies the IP address, DNS name, or host name of a proxy used to traverse a firewall and relay user queries to network resources. |
| FirewallPort | Specifies the TCP port to be used for a proxy-based firewall. |
| FirewallUser | Identifies the user ID of the account authenticating to a proxy-based firewall. |
| FirewallPassword | Specifies the password of the user account authenticating to a proxy-based firewall. |
| Property | Description |
| Logfile | Specifes the file path to the log file where the provider records its activities, such as authentication, query execution, and connection details. |
| Verbosity | Specifies the verbosity level of the log file, which controls the amount of detail logged. Supported values range from 1 to 5. |
| LogModules | Specifies the core modules to include in the log file. Use a semicolon-separated list of module names. By default, all modules are logged. |
| MaxLogFileSize | Specifies the maximum size of a single log file in bytes. For example, '10 MB'. When the file reaches the limit, the provider creates a new log file with the date and time appended to the name. |
| MaxLogFileCount | Specifies the maximum number of log files the provider retains. When the limit is reached, the oldest log file is deleted to make space for a new one. |
| Property | Description |
| Location | Specifies the location of a directory containing schema files that define tables, views, and stored procedures. Depending on your service's requirements, this may be expressed as either an absolute path or a relative path. |
| BrowsableSchemas | Optional setting that restricts the schemas reported to a subset of all available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC . |
| Tables | Optional setting that restricts the tables reported to a subset of all available tables. For example, Tables=TableA,TableB,TableC . |
| Views | Optional setting that restricts the views reported to a subset of the available tables. For example, Views=ViewA,ViewB,ViewC . |
| Property | Description |
| AutoCache | Specifies whether the content of tables targeted by SELECT queries is automatically cached to the specified cache database. |
| CacheProvider | The namespace of an ADO.NET provider. The specified provider is used as the target database for all caching operations. |
| CacheConnection | Specifies the connection string for the specified cache database. |
| CacheLocation | Specifies the path to the cache when caching to a file. |
| CacheTolerance | Notes the tolerance, in seconds, for stale data in the specified cache database. Requires AutoCache to be set to True. |
| Offline | Gets the data from the specified cache database instead of live Teradata data. |
| CacheMetadata | Determines whether the provider caches table metadata to a file-based cache database. |
| 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 | Specifies the maximum number of rows returned for queries that do not include either aggregation or GROUP BY. |
| NodeDownTimeout | (Obsolete) the number of seconds that must elapse before a connection attempt is made to a node previously marked as unavailable. |
| Other | Specifies additional hidden properties for specific use cases., to be used only when our Support team advises it, to address specific issues. See Remarks for details. |
| 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 | Toggles 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 | Specifies the maximum time, in seconds, that the provider waits for a server response before throwing a timeout error. |
| 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. |