Skip to content

Commit 08d80bf

Browse files
committed
address doc comments
1 parent a90932d commit 08d80bf

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

docs/guides/configuration.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -538,11 +538,11 @@ sqlmesh_md5__d3b07384d113edec49eaa6238ad5ff00__dev
538538

539539
This has a downside that now it's much more difficult to determine which table corresponds to which model by just looking at the database with a SQL client. However, the table names have a predictable length so there are no longer any surprises with identfiers exceeding the max length at the physical layer.
540540

541-
#### Virtual Data Environment modes
541+
#### Virtual Data Environment Modes
542542

543543
By default, Virtual Data Environments (VDE) are applied across both development and production environments. This allows SQLMesh to reuse physical tables when appropriate, even when promoting from development to production.
544544

545-
However, users may sometimes prefer their production environment to be non-virtual. The non-exhaustive list of reasons may include:
545+
However, users may prefer their production environment to be non-virtual. The non-exhaustive list of reasons may include:
546546

547547
- Integration with third-party tools and platforms, such as data catalogs, may not work well with the virtual view layer that SQLMesh imposes by default
548548
- A desire to rely on time travel features provided by cloud data warehouses such as BigQuery, Snowflake, and Databricks
@@ -565,15 +565,15 @@ To mitigate this, SQLMesh offers an alternative 'dev-only' mode for using VDE. I
565565
)
566566
```
567567

568-
As the name suggests, 'dev-only' mode means that VDE is applied only in development environments, while in production, model tables and views are updated directly, bypassing the virtual layer. This also means that physical tables in production will be created using the original, unversioned model names. Users will still benefit from VDE and data reuse across development environments.
568+
'dev-only' mode means that VDE is applied only in development environments. While in production, model tables and views are updated directly and bypass the virtual layer. This also means that physical tables in production will be created using the original, **unversioned** model names. Users will still benefit from VDE and data reuse across development environments.
569569

570570
Please note the following tradeoffs when enabling this mode:
571571

572572
- All data inserted in development environments is used only for [preview](../concepts/plans.md#data-preview-for-forward-only-changes) and will **not** be reused in production
573573
- Reverting a model to a previous version will be applied going forward and may require an explicit data restatement
574574

575575
!!! warning
576-
Switching the mode for an existing project will result in a complete rebuild of all models in the project. Refer to the [Table Migration Guide](./table_migration.md) to migrate existing tables without rebuilding them from scratch.
576+
Switching the mode for an existing project will result in a **complete rebuild** of all models in the project. Refer to the [Table Migration Guide](./table_migration.md) to migrate existing tables without rebuilding them from scratch.
577577

578578

579579
#### Environment view catalogs

0 commit comments

Comments
 (0)