Skip to content

Commit fdb7430

Browse files
authored
Apply suggestions from code review
1 parent 858eb1e commit fdb7430

File tree

1 file changed

+15
-9
lines changed

1 file changed

+15
-9
lines changed

website/docs/reference/resource-configs/fabric-configs.md

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -183,16 +183,16 @@ The `microbatch` strategy processes data in bounded time intervals using an even
183183
select * from raw_events
184184
```
185185
#### Notes
186-
- `event_time` must be a valid timestamp column.
187-
- Each batch is processed independently, allowing efficient incremental refresh of large time-series datasets.
188-
- If no `unique_key` is specified, dbt-fabric defaults to `append`.
186+
- [`event_time`](/reference/resource-configs/event-time) must be a valid timestamp column.
187+
- dbt processes each batch independently, allowing efficient incremental refresh of large time-series datasets.
188+
- If you don't specify a `unique_key`, dbt-fabric defaults to `append`.
189189

190-
For more details, see [Incremental Models](https://docs.getdbt.com/docs/build/incremental-models).
190+
For more details, see [Incremental models](/docs/build/incremental-models).
191191
## Permissions
192192

193193
The Microsoft Entra identity (user or service principal) must be a Fabric Workspace admin to work on the database level at this time. Fine grain access control will be incorporated in the future.
194194

195-
## Cross-Warehouse References
195+
## Cross-warehouse references
196196

197197
The dbt-fabric adapter supports cross-warehouse queries using `source()` or `ref()` macros.
198198

@@ -215,9 +215,15 @@ sources:
215215
```
216216
> To use cross-warehouse references or warehouse snapshots, ensure the identity configured here has access to all referenced Fabric Warehouses.
217217

218-
## Warehouse Snapshots
218+
## Warehouse snapshots
219219

220-
Microsoft Fabric’s warehouse snapshots are read-only representations of a warehouse at a specific point in time, retained for up to 30 days. They allow analysts to query a stable dataset—regardless of ongoing ETL updates—by “rolling forward” the snapshot timestamp so changes apply atomically. Warehouse snapshots are supported in dbt-fabric and allow tracking changes in Fabric Data Warehouse objects across runs. They are automatically created **before** and **after** `dbt run`, `dbt build`, and `dbt snapshot` commands. Your `profiles.yml` must define workspace_id and warehouse snapshot name to create a warehouse snapshot as a child item of your warehouse. Learn more [here](https://learn.microsoft.com/en-us/fabric/data-warehouse/warehouse-snapshot)
220+
Microsoft Fabric warehouse snapshots are read-only copies of your warehouse at a specific moment, kept for up to 30 days. They allow analysts query a stable dataset, even while ELT processes are updating the warehouse. By moving the snapshot’s timestamp forward, changes are applied all at once (atomically).
221+
222+
dbt-fabric supports warehouse snapshots, which helps track changes in Fabric Data Warehouse objects between dbt runs. Fabric automatically creates snapshots _before_ and _after_ you run the `dbt run`, `dbt build`, or `dbt snapshot` commands.
223+
224+
To use them, your `profiles.yml` must include the `workspace_id` and the warehouse snapshot name so dbt can create the snapshot as a child item of your warehouse.
225+
226+
Learn more [here](https://learn.microsoft.com/en-us/fabric/data-warehouse/warehouse-snapshot)
221227

222228
```yaml
223229
fabric_dw:
@@ -237,8 +243,8 @@ fabric_dw:
237243
- After execution, the warehouse snapshot is created with snapshot timestamp.
238244

239245
For additional details:
240-
- [dbt Snapshot Documentation](https://docs.getdbt.com/docs/build/snapshots)
241-
- [Fabric Adapter Snapshots Reference](https://docs.getdbt.com/reference/resource-configs/fabric-configs)
246+
- [dbt snapshot documentation](/docs/build/snapshots)
247+
- [Fabric adapter snapshots reference](/reference/resource-configs/fabric-configs)
242248

243249

244250
## dbt-utils

0 commit comments

Comments
 (0)