diff --git a/CHANGELOG.md b/CHANGELOG.md index 3f02138..91ba708 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,20 @@ # dbt_amazon_ads v1.3.0 -TBD +[PR #47](https://github.com/fivetran/dbt_amazon_ads/pull/47) includes the following updates: + +## Schema/Data Changes (--full-refresh required after upgrading) +**2 total changes • 1 possible breaking change** + +| Data Model(s) | Change type | Old | New | Notes | +| ------------- | ----------- | --- | --- | ----- | +| All models | `source_relation` column (when using a single Amazon Ads schema) | Empty string (`''`) | `.` | | + +## Feature Updates +- Introduces the new (recommended) `amazon_ads_sources` variable for more robust union data configuration. The old `amazon_ads_union_schemas` and `amazon_ads_union_databases` variables will still be supported. See the [README](https://github.com/fivetran/dbt_amazon_ads/tree/main#define-database-and-schema-variables) for specific details. + +## Under the Hood +- Adds the `fivetran_using_source_casing` variable for case-sensitive destination support. When enabled, downstream transformations respect source casing to ensure consistent results. See the [Additional Configurations](https://github.com/fivetran/dbt_amazon_ads/#source-casing-for-case-sensitive-destinations) section of the README for details. +- Introduces `fivetran_utils.partition_by_source_relation` to conditionally include `source_relation` in partition clauses only when multiple sources are configured. # dbt_amazon_ads v1.2.0 diff --git a/README.md b/README.md index 3907c0a..fa2643f 100644 --- a/README.md +++ b/README.md @@ -74,7 +74,7 @@ Include the following amazon_ads package version in your `packages.yml` file _if ```yaml packages: - package: fivetran/amazon_ads - version: [">=1.2.0", "<1.3.0"] # we recommend using ranges to capture non-breaking changes automatically + version: [">=1.3.0", "<1.4.0"] # we recommend using ranges to capture non-breaking changes automatically ``` > All required sources and staging models are now bundled into this transformation package. Do not include `fivetran/amazon_ads_source` in your `packages.yml` since this package has been deprecated. @@ -180,6 +180,14 @@ vars: amazon_ads__identifier: your_table_name ``` +#### Source casing for case-sensitive destinations +By default, the package applies case-insensitive comparisons when resolving `source_relation` values. If your destination is case-sensitive and you want downstream transformations to respect the exact casing of your source database and schema names, set the following variable: + +```yml +vars: + fivetran_using_source_casing: true +``` + ### (Optional) Orchestrate your models with Fivetran Transformations for dbt Core™