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

[Core] Add content to v1.9 upgrade guide for beta #6159

Closed
mirnawong1 opened this issue Sep 26, 2024 · 2 comments · Fixed by #6184
Closed

[Core] Add content to v1.9 upgrade guide for beta #6159

mirnawong1 opened this issue Sep 26, 2024 · 2 comments · Fixed by #6184
Assignees
Labels
content Improvements or additions to content dbt Core The changes proposed in this issue relate to dbt Core dbt-core v1.9

Comments

@mirnawong1
Copy link
Contributor

Link to the page(s) on docs.getdbt.com requiring updates

Add any relevant content to v1.9 upgrade guide for upcoming beta

Tell us more about this update

Please use the following template as guidance (@matthewshaver will have more info): https://docs.getdbt.com/docs/dbt-versions/core-upgrade/upgrading-to-v1.8

Reviewers/Stakeholders/SMEs

@graciegoheen
@jtcohen6

Related GitHub issues

No response

Additional information

No response

@mirnawong1 mirnawong1 added content Improvements or additions to content dbt Core The changes proposed in this issue relate to dbt Core dbt-core v1.9 labels Sep 26, 2024
@graciegoheen
Copy link
Collaborator

Now that adapters are decoupled from core.. should the 1.9 guide only focus on new "core" features (microbatch, snapshot improvements, etc.) or should it include "adapter" features still also (iceberg table format, etc.)?

cc: @jtcohen6

@graciegoheen
Copy link
Collaborator

graciegoheen commented Sep 27, 2024

My very rough thoughts on what should go in this! (cc: @dbeatty10 @jtcohen6)

Big features to highlight:

  • new microbatch incremental_strategy
    • new supporting configs (event_time, begin, lookback, batch_size
  • improvements to snapshots
    • new snapshot spec (define in yml)
    • new snapshot_meta_column_names config for customizing name of meta fields
    • target_schema is now optional for snapshots - omit for environment-aware snapshots
    • add standard schema/database configs for snapshots
    • warning when updated_at is not proper data type / timestamp
    • [maybe] new way to track deletes (config etc.)
  • [maybe] less false positives in state:modified
    • state_modified_compare_more_unrendered_values
    • state_modified_compare_vars

Small wins:

  • can now add descriptions to singular data tests
  • can use ref and source in foreign key constraints
  • can use --exclude-resource-type + associated environment variable (and "include" opposites --resource-type) in dbt test command (for excluding unit tests in production)
  • new --inline-direct parameter for 'dbt show'
  • [adapters] data_test accepts arbitrary config options (allows you to set snowflake_warehouse for tests, as an example)
  • [adapters] behavior flags

Other callouts:

  • a reminder for Cloud folks to use versionless to get access to these new features
  • a reminder that adapters have been decoupled with core (implications for installation)
  • behavior change flag callouts!
  • check with semantic layer team if there's anything to add! (time spines?) @Jstein77
  • check with adapters team if there's anything to add! @amychen1776

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
content Improvements or additions to content dbt Core The changes proposed in this issue relate to dbt Core dbt-core v1.9
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants