Skip to content

Commit 2178930

Browse files
committed
Update Direct Lake documentation
1 parent a621c26 commit 2178930

File tree

2 files changed

+20
-5
lines changed

2 files changed

+20
-5
lines changed

common/Datasets/direct-lake-dataset.md

+20-5
Original file line numberDiff line numberDiff line change
@@ -23,15 +23,30 @@ Tabular Editor 3 can create direct lake semantic models with both the Lakehouse
2323

2424
Tabular Editor 2 can connect to Direct Lake semantic models, but does not have any built in functionality to create new tables or direct lake semantic models. This needs to be done manually or with a C# script.
2525

26+
<div class="NOTE">
27+
<h5>Direct Lake limitations</h5>
28+
There are several limitations to the changes that can be made to a Direct Lake dataset: <a href="https://learn.microsoft.com/en-us/power-bi/enterprise/directlake-overview#known-issues-and-limitations">Direct Lake Known Issues and Limitations</a> We recommend <a "https://www.sqlbi.com/blog/marco/2024/04/06/direct-lake-vs-import-mode-in-power-bi/"> this article by SQLBI</a> for a initial overview of choosing between Direct Lake and Import mode.
29+
</div>
30+
31+
## Creating a Direct Lake model in Tabular Editor 3
32+
33+
Creating a Direct Lake model in Tabular Editor 3 (3.15.0 or higher) has to be specified when the model is created in the _New Model_ dialog box, by using the Direct Lake checkbox.
34+
35+
![Direct Lake New Model](~/images/common/DirectLakeNewModelDialog.png)
36+
37+
Using the checkbox ensures that Direct Lake specific properties and annotations are set, as well as limits the import of tables to Direct Lake supported sources.
38+
2639
> [!NOTE]
2740
> Direct Lake models currently use a collation that is different from regular Power BI import semantic models. This may lead to different results when querying the model, or when referencing object names in DAX code.
2841
For more information please see this blog post by Kurt Buhler: [Case-sensitive models in Power BI: consequences & considerations](https://data-goblins.com/power-bi/case-specific)
2942

43+
## Framing New Models and Table Imports
44+
45+
Tabular Editor 3 (3.15.0 or higher) automatically frames (refreshes) the model on first deployment. This is to ensure that Direct Lake mode is activated - otherwise the model would automatically fall back to DirectQuery.
46+
47+
Additionally, on import of new tables Tabular Editor 3 (3.15.0 or higher) frames (refreshes) the model when it is saved the next time. This preference is located under **Tools > Preferences > Model Deployment > Data Refresh**.
48+
3049

31-
<div class="NOTE">
32-
<h5>FABRIC IN PREVIEW</h5>
33-
Fabric is currently in preview and there are therefore several limitations to the changes that can be made to a Direct Lake dataset: <a href="https://learn.microsoft.com/en-us/power-bi/enterprise/directlake-overview#known-issues-and-limitations">Direct Lake Known Issues and Limitations</a>
34-
</div>
3550

3651
## Identifying a Direct Lake model
37-
The top title bar of Tabular Editor shows which type of model is open in that instance of Tabular Editor. Additionally, the TOM Explorer displays the type and mode of every table (Import, DirectQuery, Dual or Direct Lake). If a model contains a mix of table modes, the title bar will show "Hybrid". Currenctly, it is not possible for a DirectLake model to contain tables in Import, DirectQuery or Dual mode.
52+
The top title bar of Tabular Editor shows which type of model is open in that instance of Tabular Editor. Additionally, the TOM Explorer displays the type and mode of every table (Import, DirectQuery, Dual or Direct Lake). If a model contains a mix of table modes, the title bar will show "Hybrid". Currently, it is not possible for a DirectLake model to contain tables in Import, DirectQuery or Dual mode.
19.2 KB
Loading

0 commit comments

Comments
 (0)