Skip to content

Commit 17f20eb

Browse files
Docs: Update multi-repo docs (#3344)
Co-authored-by: Trey Spiller <1831878+treysp@users.noreply.github.com>
1 parent 59c0c08 commit 17f20eb

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

docs/guides/multi_repo.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -179,3 +179,24 @@ gateways:
179179

180180
Even if you do not have a need for multiple repos now, consider adding a `project` key so that you can easily support multiple repos in the future.
181181

182+
## Multi-Repo dbt projects
183+
184+
SQLMesh also supports multiple repos for dbt projects, allowing it to correctly detect changes and orchestrate backfills even when changes span multiple dbt projects.
185+
186+
You can watch a [quick demo](https://www.loom.com/share/69c083428bb348da8911beb2cd4d30b2) of this setup or experiment with the [multi-repo dbt example](https://github.com/TobikoData/sqlmesh/tree/main/examples/multi_dbt) yourself.
187+
188+
## Multi-repo mixed projects
189+
190+
Native SQLMesh projects can be used alongside dbt projects in a multi-repo setup.
191+
192+
This allows managing and sourcing tables from either project type within the same multi-repo project and facilitates a gradual migration from dbt to SQLMesh.
193+
194+
Use the same syntax as SQLMesh-only multi-repo projects to execute a multi-repo project with either dbt or a combination of dbt and SQLMesh projects:
195+
196+
```
197+
$ sqlmesh -p examples/multi_hybrid/dbt_repo -p examples/multi_hybrid/sqlmesh_repo plan
198+
```
199+
200+
SQLMesh will automatically detect dependencies and lineage across both SQLMesh and dbt projects, even when models are sourcing from different project types.
201+
202+
Additionally, macros can be reused across both project types. For an example of this setup, refer to the [mixed SQLMesh and dbt example](https://github.com/TobikoData/sqlmesh/tree/main/examples/multi_hybrid).

0 commit comments

Comments
 (0)