Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
Original file line number Diff line number Diff line change
Expand Up @@ -2,25 +2,28 @@
sidebar_position: 3
author: Nick Pyzik
editor: Janeth Graziani (Developer Advocate, Teradata)
email: janeth.graziani@teradata.com
page_last_update: July 16, 2025
description: Connect to Teradata VantageCloud Using DBeaver and Okta SSO (Browser Logon)
keywords: [data warehouses, compute storage separation, teradata, vantagecloud, cloud data platform, object storage, business intelligence, enterprise analytics, dbeaver, dbeaver prod, sql ide, sso]
email: developer.relations@teradata.com
page_last_update: July 2, 2026
description: Connect to Teradata Cloud Using DBeaver and Okta SSO (Browser Logon)
keywords: [data warehouses, compute storage separation, teradata, cloud data platform, object storage, business intelligence, enterprise analytics, dbeaver, dbeaver prod, sql ide, sso]
---

# Connect to Teradata VantageCloud Using DBeaver and SSO (Browser Logon)
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Connect to Teradata Cloud Using DBeaver and SSO (Browser Logon)

## Overview

This guide demonstrates how to connect to Teradata VantageCloud using DBeaver with secure **browser-based SSO authentication**.
This guide demonstrates how to connect to Teradata Cloud using DBeaver with secure **browser-based SSO authentication**.

This method uses the Teradata JDBC driver and the `LOGMECH=BROWSER` setting to enable a federated login experience, commonly used in enterprise environments.

It also provides recommended DBeaver settings to optimize the experience for Teradata users familiar with SQL Assistant.

## Prerequisites

* Access to a Teradata VantageCloud instance configured for browser-based [SSO](https://docs.teradata.com/r/Teradata-VantageCloud-Enterprise/Security/Single-Sign-on)
* Access to a Teradata Cloud instance configured for browser-based [SSO](https://docs.teradata.com/r/Teradata-VantageCloud-Enterprise/Security/Single-Sign-on)

* A valid enterprise login (e.g., @company.com credentials)
* DBeaver installed (Community or PRO version)
Expand All @@ -37,7 +40,7 @@ It also provides recommended DBeaver settings to optimize the experience for Ter

3. Change **Connect by** value from `Host` to `URL`.

4. In the **JDBC URL** field, paste the following URL (replace the YOUR-TERADATA-HOST to your VantageCloud host):
4. In the **JDBC URL** field, paste the following URL (replace the YOUR-TERADATA-HOST to your Teradata Cloud host):

```text
jdbc:teradata://<YOUR-TERADATA-HOST>/LOGMECH=BROWSER,BROWSER_TAB_TIMEOUT=0
Expand Down Expand Up @@ -71,6 +74,37 @@ and close very quickly with the following message:

DBeaver is now able to connect to Teradata!

:::note Network Access via SSH Tunnel
If your Teradata instance is on a private network (not publicly accessible), you will need to set up an SSH port-forwarding tunnel before connecting with DBeaver.

1. Open a terminal and run the following command, replacing the placeholders with values provided by your admin:

<Tabs>
<TabItem value="mac" label="Mac/Linux" default>
```bash
ssh -i ~/.ssh/tunneluser_key.pem \
-L 1025:<VANTAGE-INTERNAL-IP>:1025 \
-N <SSH-USER>@<JUMP-SERVER>
```
</TabItem>
<TabItem value="windows" label="Windows (PowerShell)">
```bash
ssh -i "$env:USERPROFILE\.ssh\tunneluser_key.pem" `
-L 1025:<VANTAGE-INTERNAL-IP>:1025 `
-N <SSH-USER>@<JUMP-SERVER>
```
</TabItem>
</Tabs>

2. Leave this terminal open while using DBeaver.

3. Use `127.0.0.1` as the host in your JDBC URL:
```text
jdbc:teradata://127.0.0.1/LOGMECH=BROWSER,BROWSER_TAB_TIMEOUT=0
```

Your admin will provide the values for `<VANTAGE-INTERNAL-IP>`, `<SSH-USER>`, and `<JUMP-SERVER>`.
:::
## Running Teradata Queries in Dbeaver

To begin querying:
Expand Down
24 changes: 12 additions & 12 deletions quickstarts/create-applications/examples-configuration.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
sidebar_position: 5
author: Tan Nguyen
email: tan.nguyen@teradata.com
page_last_update: February 13th, 2023
author: Tan Nguyen, Janeth Graziani
email: developer.relations@teradata.com
page_last_update: June 30th, 2026
description: Use Teradata Connector for MuleSoft's Anypoint Studio.
keywords: [data warehouses, compute storage separation, teradata, vantage, cloud data platform, object storage, business intelligence, enterprise analytics, mule, mulesoft, teradata connector, anypoint studio.]
keywords: [data warehouses, compute storage separation, teradata, cloud data platform, object storage, business intelligence, enterprise analytics, mule, mulesoft, teradata connector, anypoint studio.]
---

import CommunityLinkPartial from '../_partials/community_link.mdx';
Expand All @@ -15,11 +15,12 @@ Anypoint Studio (Studio) editors help you design and update your Mule applicatio

To add and configure a connector in Studio:

1. [Create a Mule Project.](#create-a-mule-project)
2. [Add the connector to your Mule project.](#add-the-connector-to-your-mule-project)
3. [Configure a source for the connector’s flow.](#configure-a-source)
4. [Add a connector operation to the flow.](#add-a-connector-operation-to-the-flow)
5. [Configure a global element for the connector.](#configure-a-global-element-for-the-connector)
1. Download and install [MuleSoft Anypoint Studio](https://www.mulesoft.com/lp/dl/anypoint-mule-studio)
2. [Create a Mule Project.](#create-a-mule-project)
3. [Add the connector to your Mule project.](#add-the-connector-to-your-mule-project)
4. [Configure a source for the connector’s flow.](#configure-a-source)
5. [Add a connector operation to the flow.](#add-a-connector-operation-to-the-flow)
6. [Configure a global element for the connector.](#configure-a-global-element-for-the-connector)


When you run the connector, you can view the app log to check for problems, as described in [View the App Log](#view-the-app-log).
Expand All @@ -40,8 +41,8 @@ In Studio, create a new Mule project in which to add and configure the connector

Add Teradata Connector to your Mule project to automatically populate the XML code with the connector's namespace and schema location and to add the required dependencies to the project's `pom.xml` file:

- In the **Mule Palette** view, click **(X) Search in Exchange**.
- In the **Add Dependencies to Project** window, type `teradata` in the search field.
- In the **Mule Palette** view, click **(X) Search in Exchange** (Sign-in may be required).
- In the **Add Dependencies or Add API to Project** window, type `teradata` in the search field.
- Click **Teradata Connector** in **Available modules**.
- Click **Add**.
- Click **Finish**.
Expand Down Expand Up @@ -123,4 +124,3 @@ Unless the log file path is customized in the app’s log file (`log4j2.xml`), y
* [Teradata Connector Reference](./teradata-connector-mule4-reference.md).
* [MuleSoft Help Center](https://help.mulesoft.com)

<CommunityLinkPartial />
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
---
sidebar_position: 18
author: Paul Ibberson
email: paul.ibberson2@teradata.com
email: paul.ibberson2@teradata.com, developer.relations@teradata.com
page_last_update: October 3rd 2024
description: Configure a Teradata Vantage connection in DataHub.
keywords: [data warehouses, compute storage separation, teradata, vantage, cloud data platform, object storage, business intelligence, enterprise analytics, datahub, data catalog, data lineage]
description: Configure a Teradata connection in DataHub.
keywords: [data warehouses, compute storage separation, teradata, cloud data platform, object storage, business intelligence, enterprise analytics, datahub, data catalog, data lineage]
---

# Configure a Teradata Vantage connection in DataHub
# Configure a Teradata connection in DataHub

## Overview

This how-to demonstrates how to create a connection to Teradata Vantage with DataHub, and ingest metadata about tables and views, along with usage and lineage information.
This how-to demonstrates how to create a connection to Teradata with DataHub, and ingest metadata about tables and views, along with usage and lineage information.

## Prerequisites

import TrialDocsNote from '../_partials/teradata_trial.mdx'

* Access to a Teradata Vantage instance.
* Access to a Teradata instance.
<TrialDocsNote />
* DataHub installed. See [DataHub Quickstart Guide](https://datahubproject.io/docs/quickstart)

Expand Down Expand Up @@ -120,12 +120,8 @@ Clicking on "Succeeded" after a sucessful execution will bring up a dialogue sim

## Summary

This how-to demonstrated how to create a connection to Teradata Vantage with DataHub in order to capture metadata of tables, views along with lineage and usage statistics.
This how-to demonstrated how to create a connection to Teradata with DataHub in order to capture metadata of tables, views along with lineage and usage statistics.

## Further reading
* [Integrate DataHub with Teradata Vantage](https://datahubproject.io/docs/generated/ingestion/sources/teradata)
* [DataHub Integration Options for Recipes](https://datahubproject.io/docs/metadata-ingestion/#recipes)

import CommunityLinkPartial from '../_partials/community_link.mdx';

<CommunityLinkPartial />
* [Integrate DataHub with Teradata](https://datahubproject.io/docs/generated/ingestion/sources/teradata)
* [DataHub Integration Options for Recipes](https://datahubproject.io/docs/metadata-ingestion/#recipes)
Loading