diff --git a/CHANGELOG.md b/CHANGELOG.md index 683b74f..fcd35d2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,19 @@ +# dbt_zendesk_source v0.11.0 + +[PR #46](https://github.com/fivetran/dbt_zendesk_source/pull/46) includes the following updates: + +## 🚨 Breaking Change Bug Fixes 🚨 +- Updated the following staging models to leverage the `{{ dbt.type_timestamp() }}` macro on timestamp fields in order to ensure timestamp with no timezone is used in downstream models. This update will cause timestamps to be converted to have no timezone. If records were reported as timezone timestamps before, this will result in converted timestamp records. + - `stg_zendesk__ticket` + - `stg_zendesk__ticket_comment` + - `stg_zendesk__ticket_field_history` + - `stg_zendesk__ticket_form_history` + - `stg_zendesk__ticket_schedule` + - `stg_zendesk__user` + +## Documentation Updates +- Updated "Zendesk" references within the README to now refer to "Zendesk Support" in order to more accurately reflect the name of the Fivetran Zendesk Support Connector. + # dbt_zendesk_source v0.10.1 [PR #43](https://github.com/fivetran/dbt_zendesk_source/pull/43) introduces the following updates: diff --git a/README.md b/README.md index 097b730..c02b199 100644 --- a/README.md +++ b/README.md @@ -13,21 +13,21 @@
-# Zendesk Source dbt Package ([Docs](https://fivetran.github.io/dbt_zendesk_source/)) +# Zendesk Support Source dbt Package ([Docs](https://fivetran.github.io/dbt_zendesk_source/)) # 📣 What does this dbt package do? -- Materializes [Zendesk staging tables](https://fivetran.github.io/dbt_github_source/#!/overview/zendesk_source/models/?g_v=1) which leverage data in the format described by [this ERD](https://fivetran.com/docs/applications/zendesk#schemainformation). These staging tables clean, test, and prepare your Zendesk data from [Fivetran's connector](https://fivetran.com/docs/applications/zendesk) for analysis by doing the following: +- Materializes [Zendesk Support staging tables](https://fivetran.github.io/dbt_github_source/#!/overview/zendesk_source/models/?g_v=1) which leverage data in the format described by [this ERD](https://fivetran.com/docs/applications/zendesk#schemainformation). These staging tables clean, test, and prepare your Zendesk Support data from [Fivetran's connector](https://fivetran.com/docs/applications/zendesk) for analysis by doing the following: - Name columns for consistency across all packages and for easier analysis - Adds freshness tests to source data - Adds column-level testing where applicable. For example, all primary keys are tested for uniqueness and non-null values. -- Generates a comprehensive data dictionary of your Zendesk data through the [dbt docs site](https://fivetran.github.io/dbt_zendesk_source/). -- These tables are designed to work simultaneously with our [Zendesk transformation package](https://github.com/fivetran/dbt_zendesk). +- Generates a comprehensive data dictionary of your Zendesk Support data through the [dbt docs site](https://fivetran.github.io/dbt_zendesk_source/). +- These tables are designed to work simultaneously with our [Zendesk Support transformation package](https://github.com/fivetran/dbt_zendesk). # 🎯 How do I use the dbt package? ## Step 1: Prerequisites To use this dbt package, you must have the following: -- A Fivetran Zendesk connector syncing data into your destination. +- A Fivetran Zendesk Support connector syncing data into your destination. - A **BigQuery**, **Snowflake**, **Redshift**, **PostgreSQL**, or **Databricks** destination. ### Databricks Dispatch Configuration @@ -39,15 +39,15 @@ dispatch: ``` ## Step 2: Install the package -Include the following zendesk_source package version in your `packages.yml` file **only if you are NOT also installing the [Zendesk transformation package](https://github.com/fivetran/dbt_zendesk)**. The transform package has a dependency on this source package. +Include the following zendesk_source package version in your `packages.yml` file **only if you are NOT also installing the [Zendesk Support transformation package](https://github.com/fivetran/dbt_zendesk)**. The transform package has a dependency on this source package. > TIP: Check [dbt Hub](https://hub.getdbt.com/) for the latest installation instructions or [read the dbt docs](https://docs.getdbt.com/docs/package-management) for more information on installing packages. ```yaml packages: - package: fivetran/zendesk_source - version: [">=0.10.0", "<0.11.0"] + version: [">=0.11.0", "<0.12.0"] ``` ## Step 3: Define database and schema variables -By default, this package runs using your target database and the `zendesk` schema. If this is not where your Zendesk data is (for example, if your zendesk schema is named `zendesk_fivetran`), add the following configuration to your root `dbt_project.yml` file: +By default, this package runs using your target database and the `zendesk` schema. If this is not where your Zendesk Support data is (for example, if your zendesk schema is named `zendesk_fivetran`), add the following configuration to your root `dbt_project.yml` file: ```yml vars: @@ -55,7 +55,7 @@ vars: zendesk_schema: your_schema_name ``` ## Step 4: Disable models for non-existent sources -This package takes into consideration that not every Zendesk account utilizes the `schedule`, `domain_name`, `user_tag`, `organization_tag`, or `ticket_form_history` features, and allows you to disable the corresponding functionality. By default, all variables' values are assumed to be `true`. Add variables for only the tables you want to disable: +This package takes into consideration that not every Zendesk Support account utilizes the `schedule`, `domain_name`, `user_tag`, `organization_tag`, or `ticket_form_history` features, and allows you to disable the corresponding functionality. By default, all variables' values are assumed to be `true`. Add variables for only the tables you want to disable: ```yml vars: using_schedules: False #Disable if you are not using schedules @@ -88,7 +88,7 @@ vars: ``` ### Change the build schema -By default, this package builds the zendesk staging models within a schema titled (`Source | \nTable | \nDescription | \nLink | \nMore? | \n
---|---|---|---|---|
\n \n {{ source.source_name }}\n \n | \n \n {{ source.name }}\n | \n \n\n View docs\n | \n\n \n \n \n \n \n \n \n \n | \n|
\n \n \n \n \n Description\n \n | \n
Source | \nTable | \nDescription | \nLink | \nMore? | \n
---|---|---|---|---|
\n \n {{ source.source_name }}\n \n | \n \n {{ source.name }}\n | \n \n\n View docs\n | \n\n \n \n \n \n \n \n \n \n | \n|
\n \n \n \n \n Description\n \n | \n