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)

  • 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

Where you can use this connection

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

Projects

  • AutoAI (Watson Machine Learning)

  • Cognos Dashboards (Cognos Dashboards service)

  • Data quality rules (IBM Knowledge Catalog, IBM Knowledge Catalog Premium). See Supported data sources for curation and data quality.

  • DataStage (DataStage service). See Connecting to a data source in DataStage. The Teradata database for DataStage connection for gives you increased performance and more features such as before and after SQL statements and reject links. However, you cannot use the Teradata database for DataStage connection outside of the DataStage service.

  • Decision Optimization (Watson Studio and Watson Machine Learning)

  • Metadata enrichment (IBM Knowledge Catalog any edition). See Supported data sources for curation and data quality.

  • Metadata import (IBM Knowledge Catalog any edition). See Supported data sources for curation and data quality. For information about the supported product versions and other prerequisites when connections are based on MANTA Automated Data Lineage for IBM Cloud Pak for Data scanners, see the Lineage Scanner Configuration section in the MANTA Automated Data Lineage on IBM Cloud Pak for Data Installation and Usage Manual. This documentation is available at https://www.ibm.com/support/pages/node/6597457.

    For metadata import (lineage), MANTA Automated Data Lineage for IBM Cloud Pak for Data and a corresponding license key must be installed. See Installing MANTA Automated Data Lineage and Enabling lineage import.

    In addition, a specific driver must be uploaded to the manta-dataflow pod or the manta-admin-gui pod. See Uploading JDBC drivers for lineage import.

  • Notebooks (Watson Studio). Click Read data on the Code snippets pane to get the connection credentials and load the data into a data structure. See Load data from data source connections.

  • SPSS Modeler (SPSS Modeler service)

  • Synthetic Data Generator (Synthetic Data Generator service)

  • Watson Machine Learning Accelerator (Watson Machine Learning Accelerator service)

Catalogs

  • Platform assets catalog

  • Other catalogs (IBM Knowledge Catalog)

Data Product Hub
You can connect to this data source from Data Product Hub. For instructions, see Connectors for Data Product Hub.
Data Virtualization service
You can connect to this data source from Data Virtualization.

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.