Skip to main content

Fusion readiness checklist

The dbt Fusion Engine is here! We currently offer it as a private preview on the dbt platform. Even if we haven't enabled it for your account, you can still start preparing your projects for upgrade. Use this checklist to ensure a smooth upgrade once Fusion becomes available. If this is all new to you, first learn about Fusion, its current state, and the features available.

Preparing for Fusion​

Use the following checklist to prepare your projects for the dbt Fusion Engine

1. Upgrade to the latest dbt version​

The Latest release track has all of the most recent features to help you prepare for Fusion.

  • Make sure all your projects are on the Latest release track across all deployment environments and jobs. This will ensure the simplest, most predictable experience by allowing you to pre-validate that your project doesn't rely on deprecated behaviors.

2. Resolve all deprecation warnings​

You must resolve deprecations while your projects are on a dbt Core release track, as they result in warnings that will become errors once you upgrade to Fusion. The autofix tool can automatically resolve many deprecations (such as moving arbitrary configs into the meta dictionary). Start a new branch to begin resolving deprecation warnings using one of the following methods:

  • Run autofix in the dbt platform: You can address deprecation warnings using the autofix tool in the Studio IDE. You can run the autofix tool on the Compatible or Latest release track.
  • Run autofix locally: Use the VS Code extension. The extension has a built-in "Getting Started" workflow that will debug your dbt project in the VS Code or Cursor IDE and execute the autofix tool. This has the added benefit of installing Fusion to your computer so you can begin testing locally before implementing in your dbt platform account.
  • Run autofix locally (without the extension): Visit the autofix GitHub repo to run the tool locally if you're not using VS Code or Cursor. This will only run the tool, it will not install Fusion.

3. Validate and upgrade your dbt packages​

The most commonly used dbt Labs managed packages (such as dbt_utils and dbt_project_evaluator) are already compatible with Fusion, as are a large number of external and community packages. We list many known supported packages here, but more exist.

  • Make sure that all of your packages are upgraded to the most recent version, many of which contain enhancements to support Fusion.
  • Check package repositories to make sure they're compatible with Fusion. If a package you use is not yet compatible, we recommend opening an issue with the maintainer, making the contribution yourself, or removing the package temporarily before you upgrade.

4. Check for known Fusion limitations​

Your project may implement features that Fusion currently limits or doesn't support.

  • Remove unnecessary features from your project to make it Fusion compatible.
  • Monitor progress for critical features, knowing we are working to bring them to Fusion. You can monitor their progress using the issues linked in the limitations table.

5. Review jobs configured in the dbt platform​

We determine Fusion eligibility using data from your job runs.

  • Ensure you have at least one job running in each of your projects in the dbt platform.
  • Delete any jobs that are no longer in use to ensure accurate eligibility reporting.
  • Make sure you've promoted the changes for deprecation resolution and package upgrades to your git branches that map to your deployment environments.

6. Stay informed about Fusion progress​

The dbt Fusion Engine remains in private preview and we currently offer it for eligible projects! We will notify you when all your projects are ready for Fusion based on our eligibility checks on your deployment jobs. In the meantime, keep up-to-date with these resources:

  • Check out the Fusion homepage for available resources, including supported adapters, prerequisites, installation instructions, limitations, and deprecations.
  • Read the Upgrade guide to learn about the new features and functionality that impact your dbt projects.
  • Monitor progress and get insight into the development process by reading the Fusion Diaries.
  • Catch up on the cost savings potential of Fusion-powered state-aware orchestration (hint: 30%+ reduction in warehouse spend!)

Was this page helpful?

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

0
Edit this page