Skip to content
This repository was archived by the owner on Jan 15, 2026. It is now read-only.

Conversation

@fivetran-joemarkiewicz
Copy link
Contributor

@fivetran-joemarkiewicz fivetran-joemarkiewicz commented Jun 18, 2025

PR Overview

Package version introduced in this PR: v0.15.0

This PR addresses the following Issue/Feature(s): Issue #94

Summary of changes:

Updates freshness to align with the new config framework introduced in dbt Core v1.9.5. Documents how users on older versions of dbt Core will/can interface with freshness

Submission Checklist

  • Alignment meeting with the reviewer (if needed)
    • Timeline and validation requirements discussed
  • Provide validation details:
    • Validation Steps: Check for unintentional effects (e.g., add/run consistency & integrity tests)

      • For validation tests I confirmed the model runs normally and the freshness tests do nothing on pre 1.9.5 and run post 1.9.5.
        • ✅ Pre 1.9.5: Nothing to do
          • image
        • ✅ Post 1.9.5: Freshness runs and fails because data is stale
          • image
    • Testing Instructions: Confirm the change addresses the issue(s)

      • Use the integration test information and confirm the model runs as expected and the freshness updates are applied as expected.
    • Focus Areas: Complex logic or queries that need extra attention

      • Confirm freshness is working as expected on >=1.9.5, but also not breaking anything in the process for older versions.

Changelog

  • Draft changelog for PR
  • Final changelog for release review

@fivetran-joemarkiewicz fivetran-joemarkiewicz marked this pull request as ready for review June 18, 2025 20:07
Copy link
Contributor

@fivetran-jamie fivetran-jamie left a comment

Choose a reason for hiding this comment

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

Overall looks good -- just need to update the dbt version to be 1.9.6 instead of 1.9.5 and the table-level freshness configs


[PR #95](https://github.com/fivetran/dbt_stripe_source/pull/95) includes the following updates:

## Breaking Change for dbt Core < 1.9.5
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
## Breaking Change for dbt Core < 1.9.5
## Breaking Change for dbt Core < 1.9.6


## Breaking Change for dbt Core < 1.9.5
> *Note: This is not relevant to Fivetran Quickstart users.*
Migrated `freshness` from a top-level source property to a source `config` in alignment with [recent updates](https://github.com/dbt-labs/dbt-core/issues/11506) from dbt Core. This will resolve the following deprecation warning that users running dbt >= 1.9.5 may have received:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Migrated `freshness` from a top-level source property to a source `config` in alignment with [recent updates](https://github.com/dbt-labs/dbt-core/issues/11506) from dbt Core. This will resolve the following deprecation warning that users running dbt >= 1.9.5 may have received:
Migrated `freshness` from a top-level source property to a source `config` in alignment with [recent updates](https://github.com/dbt-labs/dbt-core/issues/11506) from dbt Core. This will resolve the following deprecation warning that users running dbt >= 1.9.6 may have received:

into the `config` of `stripe`.
```

**IMPORTANT:** Users running dbt Core < 1.9.5 will not be able to utilize freshness tests in this release or any subsequent releases, as older versions of dbt will not recognize freshness as a source `config` and therefore not run the tests.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
**IMPORTANT:** Users running dbt Core < 1.9.5 will not be able to utilize freshness tests in this release or any subsequent releases, as older versions of dbt will not recognize freshness as a source `config` and therefore not run the tests.
**IMPORTANT:** Users running dbt Core < 1.9.6 will not be able to utilize freshness tests in this release or any subsequent releases, as older versions of dbt will not recognize freshness as a source `config` and therefore not run the tests.


**IMPORTANT:** Users running dbt Core < 1.9.5 will not be able to utilize freshness tests in this release or any subsequent releases, as older versions of dbt will not recognize freshness as a source `config` and therefore not run the tests.

If you are using dbt Core < 1.9.5 and want to continue running Stripe freshness tests, please elect **one** of the following options:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
If you are using dbt Core < 1.9.5 and want to continue running Stripe freshness tests, please elect **one** of the following options:
If you are using dbt Core < 1.9.6 and want to continue running Stripe freshness tests, please elect **one** of the following options:

**IMPORTANT:** Users running dbt Core < 1.9.5 will not be able to utilize freshness tests in this release or any subsequent releases, as older versions of dbt will not recognize freshness as a source `config` and therefore not run the tests.

If you are using dbt Core < 1.9.5 and want to continue running Stripe freshness tests, please elect **one** of the following options:
1. (Recommended) Upgrade to dbt Core >= 1.9.5
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
1. (Recommended) Upgrade to dbt Core >= 1.9.5
1. (Recommended) Upgrade to dbt Core >= 1.9.6

- Materializes [Stripe staging tables](https://fivetran.github.io/dbt_stripe_source/#!/overview/stripe_source/models/?g_v=1&g_e=seeds) which leverage data in the format described by [this ERD](https://fivetran.com/docs/applications/stripe/#schemainformation). These staging tables clean, test, and prepare your Stripe data from [Fivetran's connector](https://fivetran.com/docs/applications/stripe) for analysis by doing the following:
- Name columns for consistency across all packages and for easier analysis
- Adds freshness tests to source data
> dbt Core >= 1.9.5 is required to run freshness tests out of the box. See other options [here](https://github.com/fivetran/dbt_stripe_source/blob/main/CHANGELOG.md#breaking-change-for-dbt-core--195).
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
> dbt Core >= 1.9.5 is required to run freshness tests out of the box. See other options [here](https://github.com/fivetran/dbt_stripe_source/blob/main/CHANGELOG.md#breaking-change-for-dbt-core--195).
> dbt Core >= 1.9.6 is required to run freshness tests out of the box. See other options [here](https://github.com/fivetran/dbt_stripe_source/blob/main/CHANGELOG.md#breaking-change-for-dbt-core--196).

freshness:
warn_after: { count: 72, period: hour }
error_after: { count: 168, period: hour }
config:
Copy link
Contributor

Choose a reason for hiding this comment

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

Gotta update the table-level freshness configs as well

@fivetran-joemarkiewicz
Copy link
Contributor Author

This was addressed within PR #96

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants