diff --git a/quickstarts/analyze-data/integrate-teradata-vantage-with-knime.md b/quickstarts/analyze-data/integrate-teradata-vantage-with-knime.md index 75edcb73ea1..bb0bef3e62c 100644 --- a/quickstarts/analyze-data/integrate-teradata-vantage-with-knime.md +++ b/quickstarts/analyze-data/integrate-teradata-vantage-with-knime.md @@ -1,28 +1,28 @@ --- sidebar_position: 13 -author: Jeremy Yu -email: Jeremy.yu@teradata.com +author: Jeremy Yu, Janeth Graziani +email: Jeremy.yu@teradata.com, developer.relations@teradata.com page_last_update: May 18th, 2022 -description: Integrate Teradata Vantage with KNIME. -keywords: [data warehouses, compute storage separation, teradata, vantage, cloud data platform, object storage, business intelligence, enterprise analytics] +description: Integrate Teradata with KNIME. +keywords: [data warehouses, compute storage separation, teradata, cloud data platform, object storage, business intelligence, enterprise analytics] --- -# Integrate Teradata Vantage with KNIME Analytics Platform +# Integrate Teradata with KNIME Analytics Platform ## Overview -This how-to describes how to connect to Terdata Vantage from KNIME Analytics Platform. +This how-to describes how to connect to Terdata from KNIME Analytics Platform. ### About KNIME Analytics Platform -KNIME Analytics Platform is a data science workbench. It supports analytics on various data sources, including Teradata Vantage. +KNIME Analytics Platform is a data science workbench. It supports analytics on various data sources, including Teradata. ## Prerequisites import TrialDocsNote from '../_partials/teradata_trial.mdx' -* Access to a Teradata Vantage instance, version 17.10 or higher. +* Access to a Teradata instance, version 17.10 or higher. * KNIME installed locally. See [KNIME installation instructions](https://www.knime.com/installation) for details. @@ -32,33 +32,37 @@ import TrialDocsNote from '../_partials/teradata_trial.mdx' 2. Unzip the downloaded file. You will find `terajdbc4.jar` file. 3. In KNIME, click on `File → Preference`. Under `Databases`, click `Add`: ![Add jar](../other-integrations/images/integrate-teradata-vantage-with-knime/add-jar.png) -4. Register a new database driver. Provide values for `ID`, `Name` and `Description` like below. Click on `Add file` and point to the .jar file you downloaded earlier. Click on the `Find driver classes` and the `Driver class:` should populate with the `jdbc.TeraDriver`: -![Register driver](../other-integrations/images/integrate-teradata-vantage-with-knime/register-driver.png) +4. Register a new database driver. Provide values for `ID`, `Name`, and `Description`. Set the **URL template** to `jdbc:teradata://`. Click `Add file` and point to the `.jar` file you downloaded earlier. Click `Find driver classes` — the `Driver class` field should populate with `com.teradata.jdbc.TeraDriver`. Click `OK`: + +![Register driver](../other-integrations/images/integrate-teradata-vantage-with-knime/add-jar.png) + 5. Click `Apply and Close`: ![Apply and close](../other-integrations/images/integrate-teradata-vantage-with-knime/apply-and-close.png) -6. To test the connection, create a new KNIME workflow and add a `Database Reader (legacy)` node by dragging it to the workspace to the right: -![Test connection step 1](../other-integrations/images/integrate-teradata-vantage-with-knime/test-connection-1.png) -![Test connection step 2](../other-integrations/images/integrate-teradata-vantage-with-knime/test-connection-2.png) -7. Right-click on the `Database Reader (legacy)` to configure settings. Select `com.teradata.jdbc.Teradriver` from the drop-down: -![Start configuration](../other-integrations/images/integrate-teradata-vantage-with-knime/start-configuration.png) -8. Enter the name of the Vantage server and login mechanism, e.g.: -![Enter configuration](../other-integrations/images/integrate-teradata-vantage-with-knime/enter-configuration.png) -9. To test connection, enter SQL statement in box in lower right. For example, enter `SELECT * FROM DBC.DBCInfoV` and click `Apply` to close the dialog: -![Test connection apply](../other-integrations/images/integrate-teradata-vantage-with-knime/test-connection-apply.png) -10. Execute the node to test the connection: -![Execute node](../other-integrations/images/integrate-teradata-vantage-with-knime/execute-node.png) -11. The node will show a green light when run successfully. Right-click and select `Data from Database` to view the results: -![View results](../other-integrations/images/integrate-teradata-vantage-with-knime/view-results.png) -![View results](../other-integrations/images/integrate-teradata-vantage-with-knime/view-results-final.png) +6. Create a new KNIME workflow. Search for `DB Connector` in the Nodes panel and drag it to the workspace: -## Summary +The DB Connector settings panel will appear on the right. Configure the following: + - **Database dialect**: `Teradata` + - **Database URL**: `jdbc:teradata://` + - **Database Driver**: uncheck `Use latest driver version available` and select `Teradata Vantage` from the dropdown + - **Authentication type**: `Username and Password` + - Enter your **Username** and **Password** + - Click `Apply and Execute` It will show a green light when the connection is successful. -This how-to demonstrats how to connect from KNIME Analytics Platform to Teradata Vantage. +![Add DB Connector node](../other-integrations/images/integrate-teradata-vantage-with-knime/configure-db-connector.png) -## Further reading -* [Train ML models in Vantage using only SQL](./ml.md) -import CommunityLinkPartial from '../_partials/community_link.mdx'; +8. Add a `DB Query Reader` node to the workspace and connect the output port of `DB Connector` to the input port of `DB Reader`. + +10. Right-click the `DB Query Reader` node and select `Configure`. Enter your SQL statement, for example and select Apply and Execute: + `SELECT * FROM DBC.DBCInfoV` + +![View results](../other-integrations/images/integrate-teradata-vantage-with-knime/view-results-final.png) - \ No newline at end of file + +## Summary + +This how-to demonstrats how to connect from KNIME Analytics Platform to Teradata. + +## Further reading +* [Train ML models in Vantage using only SQL](./ml.md) \ No newline at end of file diff --git a/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/add-jar.png b/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/add-jar.png index 6de7092bcee..bcd064b101f 100644 Binary files a/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/add-jar.png and b/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/add-jar.png differ diff --git a/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/apply-and-close.png b/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/apply-and-close.png index 41ddfff79b0..6b02c6f37d7 100644 Binary files a/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/apply-and-close.png and b/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/apply-and-close.png differ diff --git a/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/configure-db-connector.png b/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/configure-db-connector.png new file mode 100644 index 00000000000..05ad0d13242 Binary files /dev/null and b/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/configure-db-connector.png differ diff --git a/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/view-results-final.png b/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/view-results-final.png index add30b8e511..be12d8cc438 100644 Binary files a/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/view-results-final.png and b/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/view-results-final.png differ diff --git a/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/view-results.png b/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/view-results.png deleted file mode 100644 index 9456d5d2de4..00000000000 Binary files a/quickstarts/other-integrations/images/integrate-teradata-vantage-with-knime/view-results.png and /dev/null differ