docs(snowflake): document transient tmp_relation_type and resolve macro - #9098
Merged
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Adds `transient` as a valid value for `tmp_relation_type` in Snowflake incremental models, explains lineage tracking benefits and fail-safe trade-offs, adds a warning about concurrent-run conflicts, and documents the `snowflake__resolve_incremental_tmp_relation` dispatch macro as the recommended fix. Tracks: dbt-labs/dbt-adapters#1894
b-per
force-pushed
the
bper/snowflake-transient-tmp-relation-docs
branch
from
May 5, 2026 08:53
8912c19 to
c515978
Compare
Contributor
Author
|
We should merge this when the new config is available (next release on the dbt platform) |
Contributor
Author
|
The underlying feature has been released and is now available on the dbt platform — marking this as ready for review. |
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the Snowflake adapter configuration docs to cover the new transient option for tmp_relation_type in incremental models, including guidance for avoiding tmp-relation naming conflicts during concurrent runs.
Changes:
- Add
transientas a documentedtmp_relation_typevalue alongsideviewandtable, with a comparison of trade-offs. - Add a warning callout about concurrent-run conflicts when using
transienttmp relations. - Document how to override
snowflake__resolve_incremental_tmp_relationto redirect tmp relations into an isolated schema.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
runleonarun
reviewed
May 12, 2026
runleonarun
left a comment
runleonarun
left a comment
Collaborator
There was a problem hiding this comment.
@b-per just a few suggestions
Co-authored-by: Leona B. Campbell <3880403+runleonarun@users.noreply.github.com>
runleonarun
approved these changes
May 13, 2026
runleonarun
left a comment
runleonarun
left a comment
Collaborator
There was a problem hiding this comment.
LGTM I will check the staging then merge
runleonarun
reviewed
May 13, 2026
runleonarun
reviewed
May 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What are you changing in this pull request and why?
Documents the new
transientoption fortmp_relation_typein Snowflake incremental models, added in dbt-labs/dbt-adapters#1894.Changes to
website/docs/reference/resource-configs/snowflake-configs.md(Temporary tables section):transientas a valid value fortmp_relation_typealongsidetableandview:::warningadmonition about concurrent-run conflicts when usingtransient(since the tmp table persists in the catalog under a deterministic name)### Avoiding tmp relation conflictssubsection documenting thesnowflake__resolve_incremental_tmp_relationdispatch macro with two usage examples (simple scratch schema and CI-job-aware schema)Checklist