Releases: fivetran/dbt_twilio
v1.1.0 dbt_twilio
PR #18 includes the following updates:
Schema/Data Change
1 total change • 0 possible breaking changes
| Data Model(s) | Change type | Old | New | Notes |
|---|---|---|---|---|
| All models | New column | source_relation |
Identifies the source connection when using multiple Twilio connections |
Feature Update
- Union Data Functionality: This release supports running the package on multiple Twilio source connections. See the README for details on how to leverage this feature.
Tests Update
- Removes uniqueness tests. The new unioning feature requires combination-of-column tests to consider the new
source_relationcolumn in addition to the existing primary key, but this is not supported across dbt versions.- These tests will be reintroduced once a version-agnostic solution is available.
Under the Hood
- Added consistency validation tests for all end models (
twilio__account_overview,twilio__message_enhanced,twilio__number_overview) to compare results between dev and prod schemas.
Full Changelog: v1.0.0...v1.1.0
v1.0.0 dbt_twilio
PR #17 includes the following updates:
Breaking Changes
Source Package Consolidation
- Removed the dependency on the
fivetran/twilio_sourcepackage.- All functionality from the source package has been merged into this transformation package for improved maintainability and clarity.
- If you reference
fivetran/twilio_sourcein yourpackages.yml, you must remove this dependency to avoid conflicts. - Any source overrides referencing the
fivetran/twilio_sourcepackage will also need to be removed or updated to reference this package. - Update any twilio_source-scoped variables to be scoped to only under this package. See the README for how to configure the build schema of staging models.
- As part of the consolidation, vars are no longer used to reference staging models, and only sources are represented by vars. Staging models are now referenced directly with
ref()in downstream models.
dbt Fusion Compatibility Updates
- Updated package to maintain compatibility with dbt-core versions both before and after v1.10.6, which introduced a breaking change to multi-argument test syntax (e.g.,
unique_combination_of_columns). - Temporarily removed unsupported tests to avoid errors and ensure smoother upgrades across different dbt-core versions. These tests will be reintroduced once a safe migration path is available.
- Removed all
dbt_utils.unique_combination_of_columnstests. - Moved
loaded_at_field: _fivetran_syncedunder theconfig:block insrc_twilio.yml.
- Removed all
Under the Hood
- Updated conditions in
.github/workflows/auto-release.yml. - Added
.github/workflows/generate-docs.yml.
Full Changelog: v0.5.0...v1.0.0
v0.5.0 dbt_twilio
PR #14 includes the following updates:
Breaking Change for dbt Core < 1.9.6
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 from dbt Core (Twilio Source v0.5.0). This will resolve the following deprecation warning that users running dbt >= 1.9.6 may have received:
[WARNING]: Deprecated functionality
Found `freshness` as a top-level property of `twilio` in file
`models/src_twilio.yml`. The `freshness` top-level property should be moved
into the `config` of `twilio`.
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.
If you are using dbt Core < 1.9.6 and want to continue running Twilio freshness tests, please elect one of the following options:
- (Recommended) Upgrade to dbt Core >= 1.9.6
- Do not upgrade your installed version of the
twiliopackage. Pin your dependency on v0.4.0 in yourpackages.ymlfile. - Utilize a dbt override to overwrite the package's
twiliosource and apply freshness via the previous release top-level property route. This will require you to copy and paste the entirety of the previous releasesrc_twilio.ymlfile and add anoverrides: twilio_sourceproperty.
Documentation
- Added Quickstart model counts to README. (#12)
- Corrected references to connectors and connections in the README. (#12)
Under the Hood
- Updates to ensure integration tests use latest version of dbt.
Full Changelog: v0.4.0...v0.5.0
v0.4.0 dbt_twilio
Features
- Added the ability to disable the
USAGE_RECORDsource table via variableusing_twilio_usage_record(defaulttrue). If disabled, downstream this will remove thetotal_account_spendfield intwilio__account_overview. Refer to the README for more details.
Under the Hood
- Removes references to unused models in
twilio__message_enhanced.
Full Changelog: v0.3.0...v0.4.0
v0.3.0 dbt_twilio
Note: This release is a 🚨 breaking change 🚨 due to breaking changes introduced in the upstream twilio_source package v0.3.0 release, where we explicitly cast the below fields as float types and remove any non-numerical characters.
-
queue_time, num_media, num_segmentsin addition to the existing float-castedduration, price, count, usagefields -
Please be aware if you were expecting string values from these fields.
Full Changelog: v0.2.0...v0.3.0
v0.2.0 dbt_twilio
Note: This release is a 🚨 breaking change 🚨 due to breaking changes introduced in the upstream twilio_source package v0.2.0 release, in which we have updated the
stg_*_tmpmodels to use thedbt_utils.starmacro instead of a basicselect *(PR #6).
Bug Fixes
- Fixed two testing-related typos in
twilio.ymlto conform to the dbt YAML file JSON schema (PR #5).- This was causing tests to not be run on the
message_idcolumn intwilio__message_enhancednor theaccount_idfield intwilio__account_overview.
- This was causing tests to not be run on the
Features
- Added the ability to disable models related to the
CALLsource table. Refer to the README for more details (twilio_source PR #5). - Ensured Fivetran's Quickstart Data Models would be able to dynamically deploy the above
CALLfeature (PR #6).
Under the Hood
- Updated the pull request templates (PR #6).
- Included auto-releaser GitHub Actions workflow to automate future releases (PR #6).
Contributors
Full Changelog: v0.1.0...v0.2.0
v0.1.0 dbt_twilio
Initial Release 🎈
This is the first release of Fivetran Twilio dbt package!
📣 What does this dbt package do?
- Produces modeled tables that leverage Twilio data from Fivetran's connector in the format described by this ERD and builds off the output of our Twilio source package.
The following table provides a detailed list of all models materialized within this package by default.
TIP: See more details about these models in the package's dbt docs site.
| Model | Description |
|---|---|
| twilio__message_enhanced | This model provides additional information of every message sent or received. |
| twilio__number_overview | This model has aggregate messaging information for each phone number level, such as total messages, total inbound messages, total messages by status, and total spend. |
| twilio__account_overview | This model provides aggregate information per each account regarding the Twilio Messages resource. |
For more information, refer to the README
This version of our dbt package focuses on Twilio's Programmable Messaging product, specifically around the Message Resource.
Submit any feedback you have here in our survey, post in our Fivetran dbt community with questions you might have, or submit any issues you encounter with our package within Github if you need any additional help!