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

feature: add new dynamic table paramaters #4835

Closed
Closed
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
33 changes: 33 additions & 0 deletions website/docs/reference/resource-configs/snowflake-configs.md
Original file line number Diff line number Diff line change
Expand Up @@ -360,6 +360,10 @@ Dynamic tables are supported with the following configuration parameters:
| [`on_configuration_change`](/reference/resource-configs/on_configuration_change) | `<string>` | no | `apply` | n/a |
| [`target_lag`](#target-lag) | `<string>` | yes | | alter |
| [`snowflake_warehouse`](#configuring-virtual-warehouses) | `<string>` | yes | | alter |
| [`refresh_mode`](#refresh-mode) | `<string>` | no | | n/a |
| [`initialize`](#initialize) | `<string>` | no | | n/a |
| [`comment`](#comment) | `<string>` | no | | n/a |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Per dbt-labs/dbt-snowflake#1081 we removed comment

Suggested change
| [`comment`](#comment) | `<string>` | no | | n/a |



<Tabs
groupId="config-languages"
Expand Down Expand Up @@ -421,6 +425,7 @@ models:
[on_configuration_change](/reference/resource-configs/on_configuration_change)="apply" | "continue" | "fail",
[target_lag](#target-lag)="downstream" | "<integer> seconds | minutes | hours | days",
[snowflake_warehouse](#configuring-virtual-warehouses)="<warehouse-name>",
[refresh_mode](#refresh-mode)="auto",
) }}
```

Expand All @@ -440,6 +445,34 @@ Snowflake allows two configuration scenarios for scheduling automatic refreshes:

Learn more about `target_lag` in Snowflake's [docs](https://docs.snowflake.com/en/user-guide/dynamic-tables-refresh#understanding-target-lag).


### Refresh Mode
Specifies the refresh type for the dynamic table.
- AUTO

Enforces an incremental refresh of the dynamic table by default. If the CREATE DYNAMIC TABLE statement does not support the incremental refresh mode, the dynamic table is automatically created with the full refresh mode.

You can verify the refresh mode using the SHOW DYNAMIC TABLES statement. The refresh_mode column shows the refresh mode in use, while the text column shows the user-specified refresh mode.
- FULL

Enforces a full refresh of the dynamic table, even if the dynamic table can be incrementally refreshed.
- INCREMENTAL

Enforces an incremental refresh of the dynamic table. If the query that underlies the dynamic table can’t perform an incremental refresh, dynamic table creation fails and displays an error message.

### Initialize
Specifies the behavior of the initial refresh of the dynamic table

- ON_CREATE

Refreshes the dynamic table synchronously at creation.
- ON_SCHEDULE

Refreshes the dynamic table at the next scheduled refresh.

### Comment
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

per dbt-labs/dbt-snowflake#1081 removing comment

Suggested change
### Comment

Specifies a comment for the dynamic table.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

per dbt-labs/dbt-snowflake#1081 removing comment

Suggested change
Specifies a comment for the dynamic table.


### Limitations

As with materialized views on most data platforms, there are limitations associated with dynamic tables. Some worth noting include:
Expand Down
Loading