Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated as per dbt-teradata 1.7.1 #5037

Merged
merged 6 commits into from
Mar 13, 2024
Merged
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
27 changes: 21 additions & 6 deletions website/docs/docs/core/connect-data-platform/teradata-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ meta:
config_page: '/reference/resource-configs/teradata-configs'
---

Some core functionality may be limited. If you're interested in contributing, check out the source code for the repository listed below.
Some core functionality may be limited. If you're interested in contributing, check out the source code in the repository listed in the next section.


import SetUpPages from '/snippets/_setup-pages-intro.md';
Expand Down Expand Up @@ -46,7 +46,7 @@ import SetUpPages from '/snippets/_setup-pages-intro.md';
|--------------|------------|-------------------|----------------|
| 1.2.x | 1.2.x | 0.1.0 | 0.9.x or below |
| 1.6.7 | 1.6.7 | 1.1.1 | 1.1.1 |
| 1.7.0 | 1.7.3 | 1.1.1 | 1.1.1 |
| 1.7.1 | 1.7.3 | 1.1.1 | 1.1.1 |


### Connecting to Teradata
Expand Down Expand Up @@ -149,15 +149,26 @@ To learn more about dbt incremental strategies please check [the dbt incremental
All dbt commands are supported.

## Support for model contracts
Model contracts are not yet supported with dbt-teradata.
Model contracts are supported with dbt-teradata v1.7.1 and onwards.
Constraint support and enforcement in dbt-teradata:

| Constraint type | Support Platform | enforcement |
|-----------------|------------------|-------------|
| not_null | ✅ Supported | ✅ Enforced |
| primary_key | ✅ Supported | ✅ Enforced |
| foreign_key | ✅ Supported | ✅ Enforced |
| unique | ✅ Supported | ✅ Enforced |
| check | ✅ Supported | ✅ Enforced |

Refer to [Model contracts](/docs/collaborate/govern/model-contracts) for more info.

## Support for `dbt-utils` package
`dbt-utils` package is supported through `teradata/teradata_utils` dbt package. The package provides a compatibility layer between `dbt_utils` and `dbt-teradata`. See [teradata_utils](https://hub.getdbt.com/teradata/teradata_utils/latest/) package for install instructions.

### Cross DB macros
Starting with release 1.3, some macros were migrated from [teradata-dbt-utils](https://github.com/Teradata/dbt-teradata-utils) dbt package to the connector. See the table below for the macros supported from the connector.
Starting with release 1.3, some macros were migrated from [teradata-dbt-utils](https://github.com/Teradata/dbt-teradata-utils) dbt package to the connector. Refer the following table for the macros supported by the connector.

For using cross DB macros, teradata-utils as a macro namespace will not be used, as cross DB macros have been migrated from teradata-utils to Dbt-Teradata.
For using cross-DB macros, teradata-utils as a macro namespace will not be used, as cross-DB macros have been migrated from teradata-utils to Dbt-Teradata.


#### Compatibility
Expand Down Expand Up @@ -217,7 +228,11 @@ For using cross DB macros, teradata-utils as a macro namespace will not be used,
## Limitations

### Transaction mode
Only ANSI transaction mode is supported.
Both ANSI and TERA modes are now supported in dbt-teradata. TERA mode's support is introduced with dbt-teradata 1.7.1, it is an initial implementation.

:::info TERA transaction mode
This is an initial implementation of the TERA transaction mode and may not support some use cases. We highly recommend validating all records or transformations using this mode to avoid unexpected issues or errors.
:::

## Credits

Expand Down
Loading