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 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 > 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
- Data quality rules (IBM Knowledge Catalog)
- DataStage (DataStage service). See Connecting to a data source in DataStage. The Teradata database for DataStage connection 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 (watsonx.ai Studio and watsonx.ai Runtime)
- Metadata enrichment (IBM Knowledge Catalog)
- Metadata import (IBM Knowledge Catalog)
- SPSS Modeler (watsonx.ai Studio)
Catalogs
-
Platform assets catalog
-
Other catalogs (IBM Knowledge Catalog)
- Data Virtualization service
- You can connect to this data source from Data Virtualization.
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.