Adding dbt-watsonx-presto setup and config files #6736

KNagaVivek · 2025-01-08T14:20:46Z

What are you changing in this pull request and why?

Adding dbt-watsonx-presto setup and config files since dbt-watsonx-presto adapter

Checklist

I have reviewed the Content style guide so my content adheres to these guidelines.
The topic I'm writing about is for specific dbt version(s) and I have versioned it according to the version a whole page and/or version a block of content guidelines.
I have added checklist item(s) to this list for anything anything that needs to happen before this PR is merged, such as "needs technical review" or "change base branch."
The content in this PR requires a dbt release note, so I added one to the release notes page.

welcome · 2025-01-08T14:20:50Z

Hello!👋 Thanks for contributing to the dbt product documentation and opening this pull request! ✨
We use Markdown and some HTML to write the dbt product documentation. When writing content, you can use our style guide and content types to understand our writing standards and how we organize information in the dbt product docs.
We'll review your contribution and respond as soon as we can. 😄

vercel · 2025-01-08T14:20:52Z

@KNagaVivek is attempting to deploy a commit to the dbt-labs Team on Vercel.

A member of the Team first needs to authorize it.

vercel · 2025-01-08T20:27:18Z

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
docs-getdbt-com	✅ Ready (Inspect)	Visit Preview	Jan 8, 2025 8:30pm

amychen1776 · 2025-01-10T13:00:17Z

website/docs/docs/core/connect-data-platform/watsonx-presto-setup.md

+
+## Host parameters
+
+The following profile fields are required for configuring watsonx.data Presto(java) connections. Currently, it supports only the `BasicAuth` authentication method. For IBM watsonx.data SaaS or Software instances, You can get the hostname and port details by clicking View connect details inside the Presto(java) engine details page.


Suggested change

The following profile fields are required for configuring watsonx.data Presto(java) connections. Currently, it supports only the `BasicAuth` authentication method. For IBM watsonx.data SaaS or Software instances, You can get the hostname and port details by clicking View connect details inside the Presto(java) engine details page.

The following profile fields are required for configuring watsonx.data Presto(java) connections. Currently, it supports only the `BasicAuth` authentication method. For IBM watsonx.data SaaS or Software instances, you can get the hostname and port details by clicking View connect details inside the Presto(java) engine details page.

This paragraph is also a tad confusing to me - does the adapter support only BasicAuth for authentication? Also I assume host and port details are required fields regardless ?

amychen1776 · 2025-01-10T13:03:55Z

website/docs/docs/core/connect-data-platform/watsonx-presto-setup.md

+
+| Option    | Required/Optional | Description | Example  |
+| --------- | ------- | ------- | ----------- |
+| `method`  | Required (default value is none) | Authentication method for Presto | `None` or `BasicAuth` |


Would the user ever want to put in None?

amychen1776 · 2025-01-10T13:48:36Z

website/docs/docs/core/connect-data-platform/watsonx-presto-setup.md

+| --------- | ------- | ------- | ----------- |
+| `method`  | Required (default value is none) | Authentication method for Presto | `None` or `BasicAuth` |
+|   `user`  | Required | Username or email for authentication. | `user` |
+| `password`| Required (if `method` is `BasicAuth`) | Password or API key for authentication | `password` |


If the adapter only supports basicauth - I would just put this as required

amychen1776 · 2025-01-10T13:49:39Z

website/docs/reference/resource-configs/watsonx-presto-config.md

+
+## Instance requirements
+
+To use IBM watsonx.data Presto(java) with dbt, ensure the instance has an attached catalog that allows creating, renaming, altering, and dropping objects such as tables and views. The user connecting to the instance with dbt must have equivalent permissions for the target catalog.


Are there any docs on the IBM side that we can link to to help users find out more?

amychen1776 · 2025-01-10T14:04:43Z

website/docs/reference/resource-configs/watsonx-presto-config.md

+```
+
+## Seeds and prepared statements
+The `dbt-watsonx-presto` adapter offers comprehensive support for all [Presto datatypes](https://prestodb.io/docs/current/language/types.html) and [watsonx.data Presto datatypes](https://www.ibm.com/support/pages/node/7157339) in seed files. However, to utilize this feature, you need to explicitly define the data types for each column in the `dbt_project.yml` file.


Is there a reason why this has to be done in the dbt_project.yml file? We support seed configs in property files too https://docs.getdbt.com/reference/seed-configs

This would also keep the project.yml file much cleaner

website/docs/reference/resource-configs/watsonx-presto-config.md

amychen1776 · 2025-01-10T14:06:45Z

website/docs/reference/resource-configs/watsonx-presto-config.md

+
+### View
+
+The `dbt-watsonx-presto` adapter supports creating views using the `materialized='view'` configuration in your dbt model. By default, when you set the materialization to view, it creates a view in watsonx.data Presto.


Views are the default setting for dbt so if the user doesn't set one, it will just create a view. I assume this is also the case for this adapter

amychen1776

Thank you for opening this! I have a few comments to ensure clarity in the documentation.

I was also curious if the adapter supports iceberg table format?

KNagaVivek added 2 commits January 8, 2025 17:34

Create watsonx-presto-config.md

6b11480

Create watsonx-presto-setup.md

f0a7676

runleonarun added the new contributor Label for first-time contributors label Jan 8, 2025

github-actions bot added content Improvements or additions to content size: medium This change will take up to a week to address labels Jan 8, 2025

vercel bot deployed to Preview January 8, 2025 20:30 View deployment

Update sidebars

cbc72cb

amychen1776 self-assigned this Jan 9, 2025

Merge branch 'current' into current

bf2f45e

KNagaVivek marked this pull request as ready for review January 10, 2025 01:50

KNagaVivek requested a review from a team as a code owner January 10, 2025 01:50

amychen1776 reviewed Jan 10, 2025

View reviewed changes

website/docs/reference/resource-configs/watsonx-presto-config.md Show resolved Hide resolved

amychen1776 reviewed Jan 10, 2025

View reviewed changes

amychen1776 requested changes Jan 10, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Adding dbt-watsonx-presto setup and config files #6736

Adding dbt-watsonx-presto setup and config files #6736

KNagaVivek commented Jan 8, 2025

welcome bot commented Jan 8, 2025

vercel bot commented Jan 8, 2025

vercel bot commented Jan 8, 2025 •

edited

Loading

amychen1776 Jan 10, 2025

amychen1776 Jan 10, 2025

amychen1776 Jan 10, 2025

amychen1776 Jan 10, 2025

amychen1776 Jan 10, 2025

amychen1776 Jan 10, 2025 •

edited

Loading

amychen1776 Jan 10, 2025

amychen1776 left a comment


		## Host parameters

		The following profile fields are required for configuring watsonx.data Presto(java) connections. Currently, it supports only the `BasicAuth` authentication method. For IBM watsonx.data SaaS or Software instances, You can get the hostname and port details by clicking View connect details inside the Presto(java) engine details page.


		## Instance requirements

		To use IBM watsonx.data Presto(java) with dbt, ensure the instance has an attached catalog that allows creating, renaming, altering, and dropping objects such as tables and views. The user connecting to the instance with dbt must have equivalent permissions for the target catalog.


		### View

		The `dbt-watsonx-presto` adapter supports creating views using the `materialized='view'` configuration in your dbt model. By default, when you set the materialization to view, it creates a view in watsonx.data Presto.

Adding dbt-watsonx-presto setup and config files #6736

Are you sure you want to change the base?

Adding dbt-watsonx-presto setup and config files #6736

Conversation

KNagaVivek commented Jan 8, 2025

What are you changing in this pull request and why?

Checklist

welcome bot commented Jan 8, 2025

vercel bot commented Jan 8, 2025

vercel bot commented Jan 8, 2025 • edited Loading

amychen1776 Jan 10, 2025

Choose a reason for hiding this comment

amychen1776 Jan 10, 2025

Choose a reason for hiding this comment

amychen1776 Jan 10, 2025

Choose a reason for hiding this comment

amychen1776 Jan 10, 2025

Choose a reason for hiding this comment

amychen1776 Jan 10, 2025

Choose a reason for hiding this comment

amychen1776 Jan 10, 2025 • edited Loading

Choose a reason for hiding this comment

amychen1776 Jan 10, 2025

Choose a reason for hiding this comment

amychen1776 left a comment

Choose a reason for hiding this comment

vercel bot commented Jan 8, 2025 •

edited

Loading

amychen1776 Jan 10, 2025 •

edited

Loading