Skip to content

Commit 99806a2

Browse files
committed
Update docs
1 parent 6b3cf6d commit 99806a2

File tree

1 file changed

+11
-10
lines changed

1 file changed

+11
-10
lines changed

docs/concepts/plans.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -43,23 +43,24 @@ This is a common choice in scenarios such as an addition of a new column, an act
4343

4444
If any downstream models contain a `select *` from the model, SQLMesh attempts to infer breaking status on a best-effort basis. We recommend explicitly specifying a query's columns to avoid unnecessary recomputation.
4545

46-
### Forward-only change
47-
A modified (either directly or indirectly) model that is categorized as forward-only will continue to use the existing physical table once the change is deployed to production (the `prod` environment). This means that no backfill will take place.
48-
49-
While iterating on forward-only changes in the development environment, the model's output will be stored in either a temporary table or a shallow clone of the production table if supported by the engine.
50-
51-
In either case the data produced this way in the development environment can only be used for preview and will **not** be reused once the change is deployed to production. See [Forward-only Plans](#forward-only-plans) for more details.
52-
53-
This category is assigned by SQLMesh automatically either when a user opts into using a [forward-only plan](#forward-only-plans) or when a model is explicitly configured to be forward-only.
54-
5546
### Summary
5647

5748
| Change Category | Change Type | Behaviour |
5849
|--------------------------------------|--------------------------------------------------------------------------------------------|----------------------------------------------------|
5950
| [Breaking](#breaking-change) | [Direct](glossary.md#direct-modification) or [Indirect](glossary.md#indirect-modification) | [Backfill](glossary.md#backfill) |
6051
| [Non-breaking](#non-breaking-change) | [Direct](glossary.md#direct-modification) | [Backfill](glossary.md#backfill) |
6152
| [Non-breaking](#non-breaking-change) | [Indirect](glossary.md#indirect-modification) | [No Backfill](glossary.md#backfill) |
62-
| [Forward-only](#forward-only-change) | [Direct](glossary.md#direct-modification) or [Indirect](glossary.md#indirect-modification) | [No Backfill](glossary.md#backfill), schema change |
53+
54+
## Forward-only change
55+
In addition to categorizing a change as breaking or non-breaking, it can also be classified as forward-only.
56+
57+
A model change classified as forward-only will continue to use the existing physical table once the change is deployed to production (the `prod` environment). This means that no backfill will take place.
58+
59+
While iterating on forward-only changes in the development environment, the model's output will be stored in either a temporary table or a shallow clone of the production table if supported by the engine.
60+
61+
In either case the data produced this way in the development environment can only be used for preview and will **not** be reused once the change is deployed to production. See [Forward-only Plans](#forward-only-plans) for more details.
62+
63+
This category is assigned by SQLMesh automatically either when a user opts into using a [forward-only plan](#forward-only-plans) or when a model is explicitly configured to be forward-only.
6364

6465
## Plan application
6566
Once a plan has been created and reviewed, it is then applied to the target [environment](environments.md) in order for its changes to take effect.

0 commit comments

Comments
 (0)