Teradata connection

To access your data in Teradata, create a connection asset for it.

Teradata provides database and analytics-related services and products.

Supported versions

Teradata databases 15.10, 16.10, 17.00, 17.10, and 17.20

Create a connection to Teradata

To create the connection asset, you need these connection details:

  • Database (optional): If you do not enter a database name, you must enter the catalog name, schema name, and the table name in the properties for SQL queries.

  • Hostname or IP address

  • Port (optional)

  • Enable trusted session (optional): You can use a trusted session to create a connection with a proxy user logged on as a trusted user. Other users can then access the connection through the proxy user.

  • Client character set (optional): IMPORTANT: Do not enter a value unless you are instructed by IBM support. The character set value overrides the Teradata JDBC drivers normal mapping of the Teradata session character sets. Data corruption can occur if you specify the wrong character set. If no value is specified, UTF16 is used.

  • Query band expression (optional): Semicolon-separated list of name-value pairs to use in the generated query band statement for the session. A query band is a set of user-defined parameters that can be set on a session, a transaction, or both to identify the originating source of a query. After you define a query band, it is passed to the Teradata database as a list of name=value pairs in a single quoted string. For example, 'ProjectName=dstage1'.

  • Authentication method: Select the security mechanism to use to authenticate the user:

    • TD2 (Teradata Method 2): Use the Teradata security mechanism.
    • LDAP: Use an LDAP security mechanism for external authentication.

  • Username and password

  • SSL certificate (if required by the database server)

For Credentials, you can use secrets if a vault is configured for the platform and the service supports vaults. For information, see Using secrets from vaults in connections.

Choose the method for creating a connection based on where you are in the platform

In a project
Click Assets > New asset > Prepare data > Connect to a data source. See Adding a connection to a project.
In a catalog
Click Add to catalog > Connection. See Adding a connection asset to a catalog.
In a deployment space
Click Import assets > Data access > Connection. See Adding data assets to a deployment space.
In the Platform assets catalog
Click New connection. See Adding platform connections.

Next step: Add data assets from the connection

Federal Information Processing Standards (FIPS) compliance

This connection can be used on a FIPS-enabled cluster (FIPS tolerant); however, it is not FIPS-compliant.

Running SQL statements

To ensure that your SQL statements run correctly, refer to the Teradata SQL documentation for the correct syntax.

Learn more

Parent topic: Supported connections


Teradata JDBC Driver 17.00.00.03 Copyright (C) 2024 by Teradata. All rights reserved. IBM provides embedded usage of the Teradata JDBC Driver under license from Teradata solely for use as part of the IBM Watson service offering.