0 / 0
Teradata connection

Teradata connection

To access your data in Teradata, you must 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 the following connection details:

  • Database name

  • Hostname or IP address

  • Port number

  • Client character set: 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.

  • 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 Private connectivity, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a secure connection.

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

In a project
Click Assets > New asset > Data access tools > Connection. 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 Add to space > Connection. See Adding connections to a deployment space.
In the Platform assets catalog
Click New connection. See Adding platform connections.

Next step: Add data assets from the connection

Where you can use this connection

You can use Teradata connections in the following workspaces and tools:


  • Data quality rules (IBM Knowledge Catalog)
  • DataStage (DataStage service). See Connecting to a data source in DataStage. The Teradata (optimized) connection gives you increased performance and more features such as before and after SQL statements and reject links. However, you cannot use the Teradata (optimized) connection outside of the DataStage service.
  • Decision Optimization (Watson Studio and Watson Machine Learning)
  • Metadata enrichment (IBM Knowledge Catalog)
  • Metadata import (IBM Knowledge Catalog)
  • SPSS Modeler (Watson Studio)


  • Platform assets catalog

  • Other catalogs (IBM Knowledge Catalog)

Watson Query service
You can connect to this data source from Watson Query.

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 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.

Generative AI search and answer
These answers are generated by a large language model in watsonx.ai based on content from the product documentation. Learn more