Skip to content

Add Teradata connector#26731

Open
sc250072 wants to merge 1 commit into
trinodb:masterfrom
Teradata:teradata-connector
Open

Add Teradata connector#26731
sc250072 wants to merge 1 commit into
trinodb:masterfrom
Teradata:teradata-connector

Conversation

@sc250072
Copy link
Copy Markdown

@sc250072 sc250072 commented Sep 28, 2025

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

  1. Create a new ClearScape Analytics™ Experience account

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

    Teradata ClearScape Analytics™ Experience

  2. Login

    Sign in with your new account at:

    ClearScape Analytics™ Experience Login

  3. Collect the API Token

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

  4. 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>`)

@cla-bot cla-bot Bot added the cla-signed label Sep 28, 2025
@github-actions github-actions Bot added the docs label Sep 28, 2025
@ebyhr ebyhr self-requested a review September 30, 2025 22:46
Comment thread plugin/trino-teradata/pom.xml Outdated
@findepi
Copy link
Copy Markdown
Member

findepi commented Oct 6, 2025

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
Copy link
Copy Markdown
Author

sc250072 commented Oct 8, 2025

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

@github-actions github-actions Bot added release-notes ui Web UI jdbc Relates to Trino JDBC driver hudi Hudi connector iceberg Iceberg connector delta-lake Delta Lake connector hive Hive connector bigquery BigQuery connector mongodb MongoDB connector snowflake Snowflake connector cassandra Cassandra connector blackhole Blackhole connector clickhouse ClickHouse connector druid Druid connector duckdb DuckDB connector elasticsearch Elasticsearch connector exasol Exasol connector faker Faker connector google-sheets Google Sheets connector ignite Ignite connector labels Nov 4, 2025
@sc250072 sc250072 force-pushed the teradata-connector branch 3 times, most recently from 6b0015c to db25a17 Compare December 13, 2025 00:46
Copy link
Copy Markdown
Member

@mosabua mosabua left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Docs look good now .. beyond that I leave it to @ebyhr @electrum and others.

@sc250072
Copy link
Copy Markdown
Author

Docs look good now .. beyond that I leave it to @ebyhr @electrum and others.

Thank you @mosabua. I have resolved all your comments.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jan 5, 2026

This pull request has gone a while without any activity. Ask for help on #core-dev on Trino slack.

@github-actions github-actions Bot added the stale label Jan 5, 2026
@sc250072 sc250072 force-pushed the teradata-connector branch 2 times, most recently from 49f0a9d to 65b3ddb Compare January 19, 2026 11:24
@github-actions github-actions Bot removed the stale label Jan 19, 2026
@sc250072 sc250072 force-pushed the teradata-connector branch 2 times, most recently from b921824 to f01eccc Compare January 20, 2026 13:40
@crispkid
Copy link
Copy Markdown

I’ve rebuilt the Trino Teradata Connector for version 479.
https://github.com/crispkid/trino-teradata

Comment thread docs/src/main/sphinx/connector/teradata.md
Comment thread docs/src/main/sphinx/connector/teradata.md
Comment thread docs/src/main/sphinx/connector/teradata.md Outdated
Comment thread docs/src/main/sphinx/connector/teradata.md Outdated
Comment thread plugin/trino-teradata/src/main/java/io/trino/plugin/teradata/TeradataClient.java Outdated
Comment thread plugin/trino-teradata/pom.xml Outdated
Comment thread plugin/trino-teradata/pom.xml Outdated
Comment thread testing/trino-product-tests/pom.xml Outdated
@sc250072 sc250072 force-pushed the teradata-connector branch 3 times, most recently from b9d20d2 to efb2971 Compare February 5, 2026 08:20
@mosabua mosabua removed hudi Hudi connector iceberg Iceberg connector delta-lake Delta Lake connector hive Hive connector bigquery BigQuery connector mongodb MongoDB connector snowflake Snowflake connector cassandra Cassandra connector labels Feb 5, 2026
Copy link
Copy Markdown
Member

@mosabua mosabua left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I had another look at the docs. Looks good now.

@github-actions
Copy link
Copy Markdown

This pull request has gone a while without any activity. Ask for help on #core-dev on Trino slack.

1 similar comment
@github-actions
Copy link
Copy Markdown

This pull request has gone a while without any activity. Ask for help on #core-dev on Trino slack.

Implement Teradata Trino Connector to handle Trino operations on Teradata,
including connector configuration, type mappings, ClearScape integration
for test environments, product tests, and documentation.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed docs jdbc Relates to Trino JDBC driver teradata ui Web UI

Development

Successfully merging this pull request may close these issues.

9 participants