Add Teradata connector

core/trino-server/src/main/provisio/trino.xml

@@ -290,6 +290,12 @@
         </artifact>
     </artifactSet>
 
+    <artifactSet to="plugin/teradata">
+        <artifact id="${project.groupId}:trino-teradata:zip:${project.version}">
+            <unpack />
+        </artifact>
+    </artifactSet>
+
     <artifactSet to="plugin/teradata-functions">
         <artifact id="${project.groupId}:trino-teradata-functions:zip:${project.version}">
             <unpack />

docs/src/main/sphinx/connector.md

@@ -42,6 +42,7 @@ SingleStore     <connector/singlestore>
 Snowflake       <connector/snowflake>
 SQL Server      <connector/sqlserver>
 System          <connector/system>
+Teradata        <connector/teradata>
 Thrift          <connector/thrift>
 TPC-DS           <connector/tpcds>
 TPC-H            <connector/tpch>

docs/src/main/sphinx/connector/teradata.md

@@ -0,0 +1,201 @@
+# Teradata connector
+
+```{raw} html
+<img src="../_static/img/teradata.png" class="connector-logo">
+```
+
+The Teradata connector allows querying and creating tables in an 
+external [Teradata](https://www.teradata.com/) database. This can be used to join data between
+different systems like Teradata and Hive, or between different
+Teradata instances.
+
+## Requirements
+
+To connect to Teradata, you need:
+
+- Teradata database 16.20 or higher.
+- Network access from the Trino coordinator and workers to Teradata. 
+- Port 1025 is the default port.
+
+## Configuration
+
+The connector can query a database on a given Teradata instance. Create a catalog
+properties file that specifies the Teradata connector by setting the
+`connector.name` to `teradata`.
+
+For example, to access a database as the `example` catalog, create the file
+`etc/catalog/example.properties`. Replace the connection properties as
+appropriate for your setup:
+
+```properties
+connector.name=teradata
+connection-url=jdbc:teradata://example.teradata.com/CHARSET=UTF8,TMODE=ANSI,LOGMECH=TD2
+connection-user=root
+connection-password=secret
+```
+
+The `connection-url` defines the connection information and parameters to pass
+to the Teradata JDBC driver. The parameters for the URL are available in the
+[Teradata JDBC documentation](https://teradata-docs.s3.amazonaws.com/doc/connectivity/jdbc/reference/current/jdbcug_chapter_2.html#BABJIHBJ).
+
+The `connection-user` and `connection-password` are typically required and
+determine the user credentials for the connection, often a service user. You can
+use {doc}`secrets </security/secrets>` to avoid actual values in the catalog
+properties files.
+
+### Connection security
+
+If you have TLS configured with a globally-trusted certificate installed on 
+your data source, you can enable TLS between your cluster and the data 
+source by appending parameters to the JDBC connection string set in the 
+connection-url catalog configuration property.
+
+For example, to specify `SSLMODE`:
+
+```properties
+connection-url=jdbc:teradata://example.teradata.com/SSLMODE=REQUIRED
+```
+
+For more information on TLS configuration options, see the
+Teradata [JDBC documentation](https://teradata-docs.s3.amazonaws.com/doc/connectivity/jdbc/reference/current/jdbcug_chapter_2.html#URL_SSLMODE).
+
+```{include} jdbc-authentication.fragment
+```
+
+### Multiple Teradata databases
+
+The Teradata connector can only access a single Teradata database within
+a single catalog. Thus, if you have multiple Teradata databases,
+or want to connect to multiple Teradata instances, you must configure
+multiple instances of the Teradata connector.
+
+To add another catalog, simply add another properties file to `etc/catalog`
+with a different name, making sure it ends in `.properties`. For example,
+if you name the property file `sales.properties`, Trino creates a
+catalog named `sales` using the configured connector.
+
+### Specific configuration properties
+
+The Teradata connector supports additional catalog properties to configure the
+behavior of the connector and the queries issued to the database.
+
+:::{list-table}
+:widths: 45, 55
+:header-rows: 1
+
+* - Property name
+  - Description
+* - `teradata.permanent-space`
+  - Permanent space allocation in bytes for new databases created via
+    `CREATE SCHEMA`. Defaults to `60000000` (60 MB). You can configure this 
+    property to specify a different permanent space allocation, or create the 
+    database manually in Teradata before using it in Trino. Refer to the 
+    [Teradata PERMANENT clause documentation](https://docs.teradata.com/r/Enterprise_IntelliFlex_VMware/SQL-Data-Definition-Language-Syntax-and-Examples/Database-Statements/CREATE-DATABASE/CREATE-DATABASE-Syntax-Elements/PERMANENT) 
+    for more information.
+:::
+
+## Type mapping
+
+Because Trino and Teradata each support types that the other does not, this
+connector {ref}`modifies some types <type-mapping-overview>` when reading data.
+Refer to the following sections for type mapping when reading data from
+Teradata to Trino.
+
+### Teradata type to Trino type mapping
+
+The connector maps Teradata types to the corresponding Trino types following
+this table:
+
+:::{list-table} Teradata type to Trino type mapping
+:widths: 40, 40, 20
+:header-rows: 1
+
+* - Teradata type
+  - Trino type
+  - Notes
+* - `TINYINT`
+  - `TINYINT`
+  -
+* - `SMALLINT`
+  - `SMALLINT`
+  -
+* - `INTEGER`
+  - `INTEGER`
+  -
+* - `BIGINT`
+  - `BIGINT`
+  -
+* - `REAL`
+  - `DOUBLE`
+  -
+* - `DOUBLE`
+  - `DOUBLE`
+  -
+* - `FLOAT`
+  - `DOUBLE`
+  -
+* - `NUMBER(p, s)`
+  - `DECIMAL(p, s)`
+  - 
+* - `NUMERIC(p, s)`
+  - `DECIMAL(p, s)`
+  - 
+* - `DECIMAL(p, s)`
+  - `DECIMAL(p, s)`
+  - 
+* - `CHAR(n)`, `CHARACTER(n)`
+  - `CHAR(n)`
+  - `CHAR` is an alias of `CHARACTER`. See [Teradata CHARACTER documentation](https://docs.teradata.com/r/Enterprise_IntelliFlex_VMware/SQL-Data-Types-and-Literals/Character-and-CLOB-Data-Types/CHARACTER-Data-Type)
+* - `VARCHAR(n)`
+  - `VARCHAR(n)`
+  - 
+* - `DATE`
+  - `DATE`
+  -
+:::
+
+No other types are supported.
+
+### Trino type to Teradata type mapping
+
+The connector maps Trino types to the corresponding Teradata types following
+this table:
+
+:::{list-table} Trino type to Teradata type mapping
+:widths: 50, 50
+:header-rows: 1
+
+* - Trino type
+  - Teradata type
+* - `TINYINT`
+  - `SMALLINT`
+* - `SMALLINT`
+  - `SMALLINT`
+* - `INTEGER`
+  - `INTEGER`
+* - `BIGINT`
+  - `BIGINT`
+* - `REAL`
+  - `FLOAT`
+* - `DOUBLE`
+  - `DOUBLE`
+* - `DATE`
+  - `DATE`
+:::
+
+No other types are supported.
+
+```{include} jdbc-type-mapping.fragment
+```
+
+## SQL support
+
+The connector provides read and limited write access to data and metadata in
+a Teradata database.  In addition to the [globally available](sql-globally-available) and
+[read operation](sql-read-operations) statements, the connector supports the
+following features:
+
+- [](/sql/create-schema)
+- [](/sql/drop-schema)
+- [](/sql/create-table)
+- [](/sql/drop-table)

plugin/trino-teradata/README.md

@@ -0,0 +1,42 @@
+# Teradata Connector Developer Notes
+
+The Teradata connector module has both unit tests and integration tests.
+The integration tests require access to a [Teradata ClearScape Analytics™ Experience](https://clearscape.teradata.com/sign-in).
+You can follow the steps below to run the integration tests locally.
+
+## Prerequisites
+
+#### 1. Create a new ClearScape Analytics™ Experience account
+
+If you don't already have one, sign up at:
+
+[Teradata ClearScape Analytics™ Experience](https://www.teradata.com/getting-started/demos/clearscape-analytics)
+
+#### 2. Login
+
+Sign in with your new account at:
+
+[ClearScape Analytics™ Experience Login](https://clearscape.teradata.com/sign-in)
+
+#### 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)>
+```
+
+## 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
+```