Skip to content

feat(rfc-0057): add teradata server type #318

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jgperrin merged 1 commit into from
Aug 18, 2026
Merged

feat(rfc-0057): add teradata server type #318

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,10 @@ RFCs targeting v3.2.0 are tracked under [`tsc/rfcs/`](https://github.com/bitol-i
* New `exasol` server `type` describing data served from Exasol, an in-memory MPP analytics database, with required `host` plus optional `port` (defaults to `8563`) and `schema`.
* No `database` field: an Exasol cluster runs a single database and the schema is the namespace. `host` may be a cluster connection range, e.g. `n11..14.acme.com`.
* Non-breaking: adds a new optional server type.
* **Adds** Teradata server type ([RFC 0057](https://github.com/bitol-io/tsc/blob/main/rfcs/approved/odcs-v3.2.0/0057-teradata-server-type.md)):
* New `teradata` server `type` describing data served from Teradata Vantage, with required `host` plus optional `port` (defaults to `1025`) and `database`.
* No `schema` field: in Teradata, the database is the namespace.
* Non-breaking: adds a new optional server type.
* **Changes** to Servers:
* Add optional Athena Server `workgroup` field and fix `stagingDir` to be optional in schema.

Expand Down
25 changes: 25 additions & 0 deletions docs/examples/server/teradata-server.odcs.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Copyright 2026 The Bitol Contributors
# SPDX-License-Identifier: Apache-2.0

# Demonstrates RFC-0057: the `teradata` server type for Teradata Vantage, an
# enterprise data warehouse. In Teradata the database is the namespace, so there
# is no `schema` field.

version: 1.0.0
apiVersion: v3.2.0
kind: DataContract
id: 3b7d1c58-2f94-4a06-8e1b-9c5a0d4f7e23
status: active
servers:
- server: prod
type: teradata
host: teradata.acme.com
port: 1025
database: SALES
schema:
- name: sales
physicalType: table
properties:
- name: sale_id
logicalType: string
required: true
14 changes: 13 additions & 1 deletion docs/infrastructure-servers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ servers:
| id | string | ID | No | A unique identifier used to reduce the risk of collisions, such as a UUID. |
| roles | array | Roles | No | List of roles that have access to the server. Check [roles](./roles.md) section for more details. |
| server | string | Server | Yes | Identifier of the server. |
| type | string | Type | Yes | Type of the server. Can be one of: api, athena, azure, bigquery, clickhouse, cloudsql, custom, databricks, db2, denodo, dremio, duckdb, exasol, glue, hive, impala, informix, kafka, kinesis, local, mysql, oracle, postgres, postgresql, presto, pubsub, redshift, s3, sftp, snowflake, sqlserver, synapse, trino, vertica, zen. |
| type | string | Type | Yes | Type of the server. Can be one of: api, athena, azure, bigquery, clickhouse, cloudsql, custom, databricks, db2, denodo, dremio, duckdb, exasol, glue, hive, impala, informix, kafka, kinesis, local, mysql, oracle, postgres, postgresql, presto, pubsub, redshift, s3, sftp, snowflake, sqlserver, synapse, teradata, trino, vertica, zen. |
| customProperties | array | Custom Properties | No | Custom properties that are not part of the standard. |

## Specific Server Properties
Expand Down Expand Up @@ -395,6 +395,18 @@ Secure File Transfer Protocol (SFTP) is a network protocol that enables secure a
| host | string | Host | Yes | The host of the Synapse server. |
| port | integer | Port | Yes | The port of the Synapse server. |

### Teradata

[Teradata Vantage](https://www.teradata.com/) is a widely used enterprise data warehouse for large-scale analytics. Added in ODCS v3.2.0 ([RFC 0057](https://github.com/bitol-io/tsc/blob/main/rfcs/approved/odcs-v3.2.0/0057-teradata-server-type.md)).

In Teradata, the database is the namespace, so there is no `schema` field.

| Key | Type | UX Label | Required | Description |
| -------- | ------- | -------- | -------- | ----------------------------------------------- |
| database | string | Database | No | Name of the database. |
| host | string | Host | Yes | Host of the Teradata server. |
| port | integer | Port | No | Port of the Teradata server. Defaults to 1025. |

### Trino Server

[Trino](https://trino.io/) is an open-source distributed SQL query engine designed to query large datasets across one or more heterogeneous data sources.
Expand Down
43 changes: 42 additions & 1 deletion schema/odcs-json-schema-latest.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -239,7 +239,7 @@
"api", "athena", "azure", "bigquery", "clickhouse", "databricks", "denodo", "dremio",
"duckdb", "exasol", "glue", "hana", "cloudsql", "db2", "hive", "iceberg", "impala", "informix", "kafka", "kinesis", "local",
"mysql", "oracle", "postgresql", "postgres", "presto", "pubsub",
"redshift", "s3", "sftp", "snowflake", "sqlserver", "synapse", "trino", "vertica", "zen", "custom"
"redshift", "s3", "sftp", "snowflake", "sqlserver", "synapse", "teradata", "trino", "vertica", "zen", "custom"
]
},
"description": {
Expand Down Expand Up @@ -718,6 +718,19 @@
"$ref": "#/$defs/ServerSource/SynapseServer"
}
},
{
"if": {
"properties": {
"type": {
"const": "teradata"
}
},
"required": ["type"]
},
"then": {
"$ref": "#/$defs/ServerSource/TeradataServer"
}
},
{
"if": {
"properties": {
Expand Down Expand Up @@ -1799,6 +1812,34 @@
"database"
]
},
"TeradataServer": {
"type": "object",
"title": "TeradataServer",
"properties": {
"host": {
"type": "string",
"description": "Host of the Teradata server.",
"examples": [
"teradata.acme.com"
]
},
"port": {
"$ref": "#/$defs/Port",
"description": "Port of the Teradata server.",
"default": 1025,
"examples": [
1025
]
},
"database": {
"type": "string",
"description": "Name of the database."
}
},
"required": [
"host"
]
},
"TrinoServer": {
"type": "object",
"title": "TrinoServer",
Expand Down
43 changes: 42 additions & 1 deletion schema/odcs-json-schema-v3.2.0.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -238,7 +238,7 @@
"api", "athena", "azure", "bigquery", "clickhouse", "databricks", "denodo", "dremio",
"duckdb", "exasol", "glue", "hana", "cloudsql", "db2", "hive", "iceberg", "impala", "informix", "kafka", "kinesis", "local",
"mysql", "oracle", "postgresql", "postgres", "presto", "pubsub",
"redshift", "s3", "sftp", "snowflake", "sqlserver", "synapse", "trino", "vertica", "zen", "custom"
"redshift", "s3", "sftp", "snowflake", "sqlserver", "synapse", "teradata", "trino", "vertica", "zen", "custom"
]
},
"description": {
Expand Down Expand Up @@ -717,6 +717,19 @@
"$ref": "#/$defs/ServerSource/SynapseServer"
}
},
{
"if": {
"properties": {
"type": {
"const": "teradata"
}
},
"required": ["type"]
},
"then": {
"$ref": "#/$defs/ServerSource/TeradataServer"
}
},
{
"if": {
"properties": {
Expand Down Expand Up @@ -1798,6 +1811,34 @@
"database"
]
},
"TeradataServer": {
"type": "object",
"title": "TeradataServer",
"properties": {
"host": {
"type": "string",
"description": "Host of the Teradata server.",
"examples": [
"teradata.acme.com"
]
},
"port": {
"$ref": "#/$defs/Port",
"description": "Port of the Teradata server.",
"default": 1025,
"examples": [
1025
]
},
"database": {
"type": "string",
"description": "Name of the database."
}
},
"required": [
"host"
]
},
"TrinoServer": {
"type": "object",
"title": "TrinoServer",
Expand Down
19 changes: 19 additions & 0 deletions src/script/negative-tests/teradata-missing-host.odcs.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Copyright 2026 The Bitol Contributors
# SPDX-License-Identifier: Apache-2.0

# RFC-0057 negative test: a `teradata` server requires `host`. Here `host` is
# omitted, so the schema MUST reject this contract.

version: 1.0.0
apiVersion: v3.2.0
kind: DataContract
id: 4e8c2a19-6b03-4d75-9f28-1a3b6c8d0e54
status: active
servers:
- server: prod
type: teradata
port: 1025
database: SALES
schema:
- name: sales
physicalType: table
Loading