The Fivetran Log connector has been renamed to the "Fivetran Platform" connector. To align with this name change, this package is largely being renamed from fivetran_log to fivetran_platform. This is a very breaking change! 🚨 🚨 🚨 🚨
Bottom Line: What you need to update and/or know:
- If you are setting any variables for this package in your
dbt_project.yml, update the name of the prefix of the variable(s) fromfivetran_log_*tofivetran_platform_*. The default values for variables have not changed. - Similarly, any references to package models will need to be updated. The prefix of package models has been updated from
fivetran_log__*tofivetran_platform__*. - If you are overriding the
fivetran_logsource, you will need to update theoverridesproperty to match the newsourcename (fivetran_platform). - Run a full refresh, as we have updated the incremental strategies across warehouses.
- The default build schema suffixes have been changed from
_stg_fivetran_logand_fivetran_logto_stg_fivetran_platformand_fivetran_platformrespectively. We recommend dropping the old schemas.
Note: Things that are NOT changing in the package:
- The name of the Github repository will not be changed. It will remain
dbt_fivetran_log - The package's project name will remain
fivetran_log. You will not need to update yourpackages.ymlreference. - The default source schema will remain
fivetran_log. The name of the source schema variable has changed though (fivetran_log_schema->fivetran_platform_schema).
See details below!
PR #81 introduced the following changes (some unrelated to the connector name change):
🚨 Breaking Changes 🚨
- Updated the prefixes of each model from
fivetran_log_*orstg_fivetran_log_*tofivetran_platform_*andstg_fivetran_platform_*, respectively.
| Original model name | New model name |
|---|---|
| fivetran_log__audit_table | fivetran_platform__audit_table |
| fivetran_log__connector_daily_events | fivetran_platform__connector_daily_events |
| fivetran_log__connector_status | fivetran_platform__connector_status |
| fivetran_log__mar_table_history | fivetran_platform__mar_table_history |
| fivetran_log__schema_changelog | fivetran_platform__schema_changelog |
| fivetran_log__transformation_status | fivetran_platform__transformation_status |
| fivetran_log__usage_mar_destination_history | fivetran_platform__usage_mar_destination_history |
| stg_fivetran_log__account | stg_fivetran_platform__account |
| stg_fivetran_log__connector | stg_fivetran_platform__connector |
| stg_fivetran_log__credits_used | stg_fivetran_platform__credits_used |
| stg_fivetran_log__destination_membership | stg_fivetran_platform__destination_membership |
| stg_fivetran_log__destination | stg_fivetran_platform__destination |
| stg_fivetran_log__incremental_mar | stg_fivetran_platform__incremental_mar |
| stg_fivetran_log__log | stg_fivetran_platform__log |
| stg_fivetran_log__transformation | stg_fivetran_platform__transformation |
| stg_fivetran_log__trigger_table | stg_fivetran_platform__trigger_table |
| stg_fivetran_log__usage_cost | stg_fivetran_platform__usage_cost |
| stg_fivetran_log__user | stg_fivetran_platform__user |
- Updated the prefix of all package variables from
fivetran_log_*tofivetran_platform_*.
| Original variable name | New variable name | Default value (consistent) |
|---|---|---|
| fivetran_log_schema | fivetran_platform_schema | fivetran_log
|
| fivetran_log_database | fivetran_platform_database | target.database
|
| fivetran_log__usage_pricing | fivetran_platform__usage_pricing | Dynamically checks the source at runtime to set as either true or false. May be overridden using this variable if desired.
|
| fivetran_log__credits_pricing | fivetran_platform__credits_pricing | Dynamically checks the source at runtime to set as either true or false. May be overridden using this variable if desired
|
| fivetran_log_using_sync_alert_messages | fivetran_platform_using_sync_alert_messages | True
|
| fivetran_log_using_transformations | fivetran_platform_using_transformations | True
|
| fivetran_log_using_triggers | fivetran_platform_using_triggers | True
|
| fivetran_log_using_destination_membership | fivetran_platform_using_destination_membership | True
|
| fivetran_log_using_user | fivetran_platform_using_user | True
|
| fivetran_log_[default_table_name]_identifier | fivetran_platform_[default_table_name]_identifier | Default table name (ie 'connector' for fivetran_platform_connector_identifier)
|
- Updated the default build schema suffixes of package models from
_stg_fivetran_logand_fivetran_logto_stg_fivetran_platformand_fivetran_platformrespectively.
We recommend dropping the old schemas to eradicate the stale pre-name-change models from your destintation.
- Updated the name of the package's source from
fivetran_logtofivetran_platform. - Updated the name of the packages' schema files:
src_fivetran_log.yml->src_fivetran_platform.ymlstg_fivetran_log.yml->stg_fivetran_platform.ymlfivetran_log.yml->fivetran_platform.yml
- Updated the freshness tests on the
fivetran_platformsource to be less stringent and more realistic. The following source tables have had their default fresness tests removed, as they will not necessarily update frequently:connectoraccountdestinationdestination_membershipuser
- Updated the incremental strategy of the audit table model for BigQuery and Databricks users from
mergeto the more consistentinsert_overwritemethod. We have also updated thefile_formattoparquetand added a partition on a newsync_start_dayfield for Databricks. This field is merely a truncated version ofsync_start.- Run a full refresh to capture these new changes. We recommend running a full refresh every so often regardless. See README for more details.
- The
account_membershipsource table (and any of its transformations) has been deprecated. Fivetran deprecated this table from the connector in June 2023.
Considerations
- ⚠️ If you are overriding the
fivetran_logsource, you will need to update theoverridesproperty to match the newsourcename (fivetran_platform).
Under the Hood
- Added documentation for fields missing yml entries.
- Incorporated the new
fivetran_utils.drop_schemas_automationmacro into the end of each Buildkite integration test job (PR #80). - Updated the pull request templates (PR #80).
Full Changelog: v0.7.4...v1.0.0
