Add Teradata connector #26731

sc250072 · 2025-09-28T16:39:47Z

Description

This PR introduces the Teradata connector, enabling Trino to query and interact with Teradata data sources.

Key additions:

Implements the Teradata connector SPI with support for:
• Connection setup
• Schema retrieval
• Data type mapping

Adds integration tests against a Teradata ClearScape Analytics™ Experience instance to verify connection, query execution, and result mapping.
Updates documentation under connectors to include usage examples and configuration options.
This connector extends Trino’s ecosystem to support Teradata users, allowing them to leverage Trino’s distributed query engine for federated queries.

Additional context and related issues

The Teradata connector module has both unit tests and integration tests.
The integration tests require access to a Teradata ClearScape Analytics™ Experience.
You can follow the steps below to run the integration tests locally.

A new PR has been created for the Teradata connector to replace PR #26574
, with a reduced scope based on the recommendation in this review comment
. Additional review comments from the earlier PR have also been addressed.

Prerequisites

Create a new ClearScape Analytics™ Experience account

If you don't already have one, sign up at:

Teradata ClearScape Analytics™ Experience
Login

Sign in with your new account at:

ClearScape Analytics™ Experience Login
Collect the API Token

Use the Copy API Token button in the UI to retrieve your token.

Define the following environment variables

⚠️ Note: The Teradata database password must be at least 8 characters long.

export CLEARSCAPE_TOKEN=<API Token>
export CLEARSCAPE_PASSWORD=<Password for Teradata database (min 8 chars)>
export CLEARSCAPE_REGION=us-central;

Running Integration Tests

Once the environment variables are set, run the integration tests with:

⚠️ Note: Run the following command from the Trino parent directory.

./mvnw clean install -pl :trino-teradata

Release notes

( ) This is not user-visible or is docs only, and no release notes are required.
(x ) Release notes are required. Please propose a release note for me.
( ) Release notes are required, with the following suggested text:

## Connectors
* Add Teradata connector. ({issue}`<issue-number-if-any>`)

…radata

…nector

chenjian2664 · 2025-10-03T03:56:06Z

...trino-teradata/src/test/java/io/trino/plugin/integration/clearscape/EnvironmentResponse.java

+
+import java.util.List;
+
+public record EnvironmentResponse(


add a compact constructor and add rnn check

Same as others

chenjian2664 · 2025-10-03T03:56:17Z

plugin/trino-teradata/src/test/java/io/trino/plugin/integration/clearscape/ClearScapeSetup.java

+            boolean destroyEnv,
+            String region)
+    {
+        this.token = token;


requirednotnull check added

chenjian2664 · 2025-10-03T03:56:54Z

plugin/trino-teradata/src/test/java/io/trino/plugin/integration/clearscape/Headers.java

+    public static final String BEARER = "Bearer ";
+
+    private Headers()
+    {


nit:

private Headers() {}

chenjian2664 · 2025-10-03T03:58:11Z

plugin/trino-teradata/src/test/java/io/trino/plugin/integration/TeradataConnectorTest.java

+
+    @AfterAll
+    public void cleanupTestDatabase()
+    {


we could use closeAfterClass

updated with closeAfterClass

chenjian2664 · 2025-10-03T03:58:58Z

plugin/trino-teradata/src/test/java/io/trino/plugin/integration/TeradataConnectorTest.java

+    @Test
+    public void testAddColumn()
+    {
+        Assumptions.abort("Skipping as connector does not support column level write operations");


static import

Same other places

addressed all applicable places

Thank you @chenjian2664 for your review. addressed all your review comments.

findepi · 2025-10-06T19:59:49Z

plugin/trino-teradata/pom.xml

+
+        <dependency>
+            <groupId>com.teradata.jdbc</groupId>
+            <artifactId>terajdbc</artifactId>


Maven central lists this with "Teradata Generic Download License" license.
Is that license compatible for inclusion in Apache project?

Hi @findepi, Thanks for pointing this out. The Teradata JDBC driver is distributed under the "Teradata Generic Download License" and is free to download and use.

We are currently using the same driver in the Airbyte project for the Teradata connector without issues.

That said, we are checking internally with our legal team to confirm whether this license is compatible for inclusion in Apache projects like Trino. We’ll get back to you as soon as we have a confirmation.

findepi · 2025-10-06T19:59:53Z

The Teradata connector module has both unit tests and integration tests.
The integration tests require access to a Teradata ClearScape Analytics™ Experience.

How will these tests be run on Trino CI?

sc250072 · 2025-10-08T04:32:07Z

The Teradata connector module has both unit tests and integration tests.
The integration tests require access to a Teradata ClearScape Analytics™ Experience.

How will these tests be run on Trino CI?

Thank you @findepi for your review. We need Trino team help to configure required environment variables to run Teradata connector integration tests and need to update Trino CI to include Teradata integration tests

sc250072 added 2 commits September 28, 2025 21:50

Implemented Teradata Trino Connector to handle Trino operations on Te…

7d8404e

…radata

Add Teradata connector documentation entry

61759f5

cla-bot bot added the cla-signed label Sep 28, 2025

github-actions bot added the docs label Sep 28, 2025

sc250072 mentioned this pull request Sep 28, 2025

Add Teradata connector #26574

Closed

sc250072 added 2 commits September 28, 2025 22:23

sorted after teradata entry added

ad0e666

Add overrides for timestamp with time zone test cases in Teradata con…

08574e5

…nector

ebyhr self-requested a review September 30, 2025 22:46

chenjian2664 reviewed Oct 3, 2025

View reviewed changes

sc250072 added 2 commits October 6, 2025 06:48

PR review comments addressed

e7fa580

Fixed static check issues

80de153

findepi reviewed Oct 6, 2025

View reviewed changes

Add Teradata connector #26731

Are you sure you want to change the base?

Add Teradata connector #26731

Uh oh!

Conversation

sc250072 commented Sep 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Additional context and related issues

Prerequisites

Running Integration Tests

Release notes

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sc250072 Oct 6, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

findepi commented Oct 6, 2025

Uh oh!

sc250072 commented Oct 8, 2025

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

3 participants

sc250072 commented Sep 28, 2025 •

edited

Loading

sc250072 Oct 6, 2025 •

edited

Loading