Skip to main content

Sync back to dbt

Now that you've documented your tables and columns, propagated descriptions and automatically documented your tables, you can sync those descriptions back to your dbt yml files!

Requirements​

For GitHub:​

  • We only need you to grant contributor access to our technical GitHub user techcastor to your dbt GitHub repository so we can push a new branch with the updates. For more details on this check here
  • Here is the user: https://github.com/techcastor
  • Works with both dbt Core and dbt Cloud, as long as the underlying git repo is on GitHub

For GitLab:​

  • We need a Project Access Token (PAT) to your dbt GitLab repository, more information here
  • In token configuration the only scope needed is write_repository and Contributor role must be selected so we can push a new branch with the updates
  • The token should then be sent to our support either through catalog-support@coalesce.io or Slack alongside the HTTP needed to clone the repository

How-to​

1. On the integration page, click on this button to request a sync:​

info

If you didn't open the GitHub access prior to clicking the button, the Catalog team will reach out!

2. You'll see a new branch called castor-sync-back appear after a while on your repository​