You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
540
540
541
-
#### Virtual Data Environment modes
541
+
#### Virtual Data Environment Modes
542
542
543
543
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.
544
544
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:
546
546
547
547
- 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
548
548
- 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
565
565
)
566
566
```
567
567
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.
569
569
570
570
Please note the following tradeoffs when enabling this mode:
571
571
572
572
- 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
573
573
- Reverting a model to a previous version will be applied going forward and may require an explicit data restatement
574
574
575
575
!!! 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.
0 commit comments