diff --git a/quickstarts/connect-to-vantage/connect-teradata-dbeaver-okta-sso.md b/quickstarts/connect-to-vantage/connect-teradata-dbeaver-okta-sso.md new file mode 100644 index 00000000000..bd7f3c4098c --- /dev/null +++ b/quickstarts/connect-to-vantage/connect-teradata-dbeaver-okta-sso.md @@ -0,0 +1,190 @@ +--- +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] +--- + +# Connect to Teradata VantageCloud 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 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) + +* A valid enterprise login (e.g., @company.com credentials) +* DBeaver installed (Community or PRO version) + + Download from [DBeaver Community](https://dbeaver.io/download) or [DBeaver PRO](https://dbeaver.com/download) + +## Create a Teradata Connection with SSO + +1. Open DBeaver and click the plug icon (![Add Connection Plug Icon](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/plug-icon.png)) in the upper left, or navigate to `Database -> New Database Connection`. + +2. In the **Select your database** screen, type `teradata`, select the **Teradata** connector, and click **Next**. + + ![Select Teradata connector](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/teradata_connector.png) + +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): + + ```text + jdbc:teradata:///LOGMECH=BROWSER,BROWSER_TAB_TIMEOUT=0 + + ``` + +> Replace `` with the hostname of your Teradata gateway or VantagCloud environment. + +> **Important:** Do NOT enter a username or password. Authentication will occur through your browser. + + + ![JDBC Connection Settings](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/jdbc_connection_settings.png) + +5. Click **Test Connection**. + +6. If prompted, download and install the Teradata JDBC driver. +(You may not be prompted if the driver is already installed from previous use.) + +![Browser Login](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/browser_login.png) + +7. A browser window will open and redirect you to your organization's SSO login page. Log in with your enterprise credentials. + +8. Once authenticated, a browser window will open +and close very quickly with the following message: + +![Authentication Complete](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/authentication_complete.png) + +10. DBeaver should confirm a successful connection. Click **OK** and then **Finish**. + +![Connection Test](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/connection_test.png) + +DBeaver is now able to connect to Teradata! + +## Running Teradata Queries in Dbeaver + +To begin querying: + +- Right-click your Teradata connection and select **Connect** +- Open a new SQL script window and write your query. + + +![Connect](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/connect.png) + +Click the upper orange arrow to execute the SQL query, or press `Command + Return` (macOS) or `Ctrl + Enter` (Windows). + +![Query](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/query.png) + + +## Recommended DBeaver Settings for Teradata Users + +### Disable "Blank line is statement delimiter" + +Prevents DBeaver from ending queries at empty lines. + +Navigate to: + +Window -> Preferences -> Editors -> SQL Editor -> SQL Processing -> Delimiters -> + +Set **Blank line is a statement delimiter** to `Never`. + +![SQL Processing Settings](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/sql_processing.png) + +### Disable Removal of Trailing Query Delimiters + +Ensures semicolons are preserved when queries are executed. + +Navigate to: +Window -> Preferences -> Editors -> SQL Editor -> SQL Processing -> Delimiters + +Uncheck **Remove trailing query delimiter**. + + +![SQL Processing Settings](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/sql_processing.png) + +### Enable Line Numbers + +Navigate to: +Window -> Preferences -> Editors -> Text Editors + +Check **Show line numbers**. + +![Enable Line Numbers](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/sql_processing.png) + + +### Disable Insert Table Aliases + +Navigate to: + +Window -> Preferences -> Editors -> SQL Editor -> Code Completion + +Set **Insert table aliases** to `N/A`. + +![Table Aliases](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/table_aliases.png) + +### Use Column Names Instead of Labels + +Navigate to: + +Window -> Preferences -> Editors -> Data Editor + +Check **Use column names instead of column labels**. + +![Column Names](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/column_names.png) + + +## How-to + +### Display the Sum, Min, Max, etc. of a Column + +After running a query, click the **Calc** button under the **Panels** menu on the right side of the Answer Set. + + +![Calc](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/calc.png) + +You may see existing calculations such as *Count*. Click the **plus (+)** sign to add more. + + +![Add Calculation](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/add_calc.png) + +### Change Shortcut Keys + +To reassign keyboard shortcuts (e.g., run a query with `F5` instead of `Ctrl+Enter`): + +1. Go to `Window` → `Preferences` +2. Search for **Keys** in the search bar and select `Execute SQL query` +3. In the **Binding** section: + - Remove `Ctrl+Enter` + - Press the desired key (e.g., `F5`) + - Click **Apply and Close** + + + ![Change Shortcut Keys](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/change_shortcut_keys.png) + + +## FAQ + +| **Question** | **Answer** | +|--------------|------------| +| How do I copy both headers and data from results? | Select the data, press `Ctrl+Shift+C`, then click **OK** | +| How can I get all rows of data from a query? | DBeaver limits results to 2k rows by default. Right-click the results and select **Read All Rows** or change the limit in settings ![Select ALL Rows in Query](../other-integrations/images/configure-a-teradata-connection-in-dbeaver/select_all_rows.png)| +| How do I duplicate a connection? | Right-click the existing connection and choose **Copy/Paste** | +| How do I run multiple DDL/DML statements? | Use **Execute SQL Script** instead of **Execute SQL Query** | +| How do I change the date format in results? | Teradata defaults to `YYYY-MM-DD`. To change formats, follow DBeaver’s [Managing Data Formats](https://dbeaver.com/docs/dbeaver/Managing-Data-Formats/) guide | +| How can I run parameterized SQL queries (prompted SQL)? | Go to `Editors` → `SQL Editor` → `SQL Processing`, then enable:
• **Anonymous SQL parameters**
• **Enable parameters in DDL and $$..$$ blocks**

Example: `SELECT * FROM my_table WHERE column = :PARAM;` | +| How do I rename a connection? | Right-click the connection and choose **Rename** | + + +## Summary + +This guide demonstrated how to connect to Teradata Vantage using browser-based SSO in DBeaver. This method enables secure enterprise login without manually entering credentials. It also provided recommended DBeaver settings to optimize the experience for Teradata users familiar with SQL Assistant. \ No newline at end of file diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/add_calc.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/add_calc.png new file mode 100644 index 00000000000..f866d2bc0db Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/add_calc.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/authentication_complete.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/authentication_complete.png new file mode 100644 index 00000000000..30d832eabd7 Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/authentication_complete.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/browser_login.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/browser_login.png new file mode 100644 index 00000000000..05d35e60b1a Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/browser_login.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/calc.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/calc.png new file mode 100644 index 00000000000..ba18a3b3781 Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/calc.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/change_shortcut_keys.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/change_shortcut_keys.png new file mode 100644 index 00000000000..3350c0b88d7 Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/change_shortcut_keys.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/column_names.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/column_names.png new file mode 100644 index 00000000000..651baaef7fd Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/column_names.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/connect.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/connect.png new file mode 100644 index 00000000000..c0f876ec02f Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/connect.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/connection_test.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/connection_test.png new file mode 100644 index 00000000000..5f388489d7d Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/connection_test.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/jdbc_connection_settings.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/jdbc_connection_settings.png new file mode 100644 index 00000000000..132c72bf6c5 Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/jdbc_connection_settings.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/query.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/query.png new file mode 100644 index 00000000000..208e4c3ae3c Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/query.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/select_all_rows.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/select_all_rows.png new file mode 100644 index 00000000000..e948182caa4 Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/select_all_rows.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/show_line_numbers.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/show_line_numbers.png new file mode 100644 index 00000000000..0fecf7ee112 Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/show_line_numbers.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/sql_processing.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/sql_processing.png new file mode 100644 index 00000000000..4e5db950a23 Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/sql_processing.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/table_aliases.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/table_aliases.png new file mode 100644 index 00000000000..f950c0d6422 Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/table_aliases.png differ diff --git a/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/teradata_connector.png b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/teradata_connector.png new file mode 100644 index 00000000000..ab07058980f Binary files /dev/null and b/quickstarts/other-integrations/images/configure-a-teradata-connection-in-dbeaver/teradata_connector.png differ