Prerequisites
- A connected git provider so Paradime can post PR comments.
- A production connection with access to your sources and models, so Paradime can run information schema queries and build field-level lineage.
- At least one Turbo CI schedule configured, which is required to generate field-level lineage.
Steps
1
Confirm your production connection and Turbo CI
Make sure your production connection is in place and at least one Bolt Turbo CI schedule runs successfully. Together they let Paradime build the field-level lineage the diff relies on.
2
Connect your git provider
Connect the git provider that hosts your dbt™ repository so Paradime can read pull requests and post comments back. Follow the reference page for your provider in the section below.
3
Connect your BI tools
Connect BI tools like Looker, Tableau, or ThoughtSpot so the report also surfaces affected dashboards and other downstream assets, not only dbt™ models.
Connecting BI tools gives you the widest impact coverage, so reviewers see the full downstream picture.
4
Open a pull request with a column change
Open a test PR that renames, removes, or adds a column in a SELECT statement, for example renaming
customer_name to full_name. These structural SELECT changes are what the diff detects.The diff tracks structural changes to SELECT statements (column renames, removals, and additions). It does not track logic changes in
WHERE, JOIN, GROUP BY, or ORDER BY clauses, or changes to how a column value is calculated.5
Review the impact report
Paradime posts an automated comment on the PR listing all impacted downstream dbt™ models and BI nodes. Use it to assess the potential impact of the change before approving.
You’ll know it worked when your test PR receives an automated comment listing the affected downstream nodes. If the comment reports it can’t find your public git email address, complete the git provider setup for the user opening the PR on the provider reference page.
Set up your git provider
Finish the connection on the reference page for your provider. BI integrations for Looker, Tableau, and ThoughtSpot are covered from the same section.GitHub
GitLab
Azure DevOps
BitBucket
Next steps
Set up Turbo CI
Run and test dbt™ changes on every pull request.
Lineage Diff reference
Supported changes, BI integrations, and setup details.