Skip to content

Commit f443241

Browse files
committed
Update watsonx-presto-config
1 parent e50f831 commit f443241

File tree

1 file changed

+16
-41
lines changed

1 file changed

+16
-41
lines changed

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

Lines changed: 16 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,13 @@ id: "watsonx-presto-configs"
55

66
## Instance requirements
77

8-
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.
8+
To use IBM watsonx.data Presto(java) with `dbt-watsonx-presto` adapter, ensure the instance has an attached catalog that supports creating, renaming, altering, and dropping objects such as tables and views. The user connecting to the instance via the `dbt-watsonx-presto` adapter must have the necessary permissions for the target catalog.
9+
10+
For detailed setup instructions, including setting up watsonx.data, adding the Presto(Java) engine, configuring storages, registering data sources, and managing permissions, refer to the official IBM documentation:
11+
- watsonx.data Software Documentation: [IBM watsonx.data Software Guide](https://www.ibm.com/docs/en/watsonx/watsonxdata/2.1.x)
12+
- watsonx.data SaaS Documentation: [IBM watsonx.data SaaS Guide](https://cloud.ibm.com/docs/watsonxdata?topic=watsonxdata-getting-started)
13+
14+
915

1016
## Session properties
1117

@@ -43,42 +49,19 @@ hive.allow-rename-table=true
4349

4450
```
4551

46-
## File format configuration
47-
48-
For file-based connectors, such as Hive, you can customize table materialization and data formats. For example, to create a partitioned [Parquet](https://spark.apache.org/docs/latest/sql-data-sources-parquet.html) table:
49-
50-
```sql
51-
{{
52-
config(
53-
materialized='table',
54-
properties={
55-
"format": "'PARQUET'",
56-
"partitioning": "ARRAY['bucket(id, 2)']",
57-
}
58-
)
59-
}}
60-
```
61-
6252
## Seeds and prepared statements
63-
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.
53+
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. To leverage this functionality, you must explicitly define the data types for each column.
6454

65-
To configure column data types, update your `<project_name>/dbt_project.yml` file as follows:
55+
You can configure column data types either in the dbt_project.yml file or in property files, as supported by dbt. For more details on seed configuration and best practices, refer to the [dbt seed configuration documentation](https://docs.getdbt.com/reference/seed-configs).
6656

67-
```sh
68-
seeds:
69-
<project_name>:
70-
<seed_file_name>:
71-
+column_types:
72-
<col_1>: <datatype>
73-
<col_2>: <datatype>
74-
```
75-
This ensures that dbt correctly interprets and applies the specified data types when loading seed data into your watsonx.data Presto instances.
57+
## Materializations
58+
The `dbt-watsonx-presto` adapter supports both table and view materializations, allowing you to manage how your data is stored and queried in watsonx.data Presto(java).
7659

60+
For further information on configuring materializations, refer to the [dbt materializations documentation](https://docs.getdbt.com/reference/resource-configs/materialized).
7761

78-
## Materializations
7962
### Table
8063

81-
The `dbt-watsonx-presto` adapter helps you create and update tables through table materialization, making it easier to work with data in watsonx.data Presto.
64+
The `dbt-watsonx-presto` adapter enables you to create and update tables through table materialization, making it easier to work with data in watsonx.data Presto.
8265

8366
#### Recommendations
8467
- **Check Permissions:** Ensure that the necessary permissions for table creation are enabled in the catalog or schema.
@@ -93,20 +76,12 @@ PrestoUserError(type=USER_ERROR, name=NOT_SUPPORTED, message="This connector doe
9376

9477
### View
9578

96-
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.
97-
98-
```sql
99-
{{
100-
config(
101-
materialized='view',
102-
)
103-
}}
104-
```
79+
The `dbt-watsonx-presto` adapter automatically creates views by default, as views are the standard materialization in dbt. If no materialization is explicitly specified, dbt will create a view in watsonx.data Presto.
10580

106-
For more details, refer to the watsonx.data [sql statement support](https://www.ibm.com/support/pages/node/7157339) or Presto [connector documentation](https://prestodb.io/docs/current/connector.html) to verify whether your connector supports view creation.
81+
To confirm whether your connector supports view creation, refer to the watsonx.data [sql statement support](https://www.ibm.com/support/pages/node/7157339) or Presto [connector documentation](https://prestodb.io/docs/current/connector.html).
10782

10883

109-
### Unsupported Features
84+
## Unsupported Features
11085
The following features are not supported by the `dbt-watsonx-presto` adapter
11186
- Incremental Materialization
11287
- Materialized Views

0 commit comments

Comments
 (0)