OneLake-Integration für Semantikmodelle

  • Artikel

Wichtig

Die OneLake-Integration für Semantikmodelle befindet sich derzeit in der Vorschau.

Mit der Microsoft OneLake-Integration für Semantikmodelle können Daten, die in Modelltabellen importiert werden, auch automatisch in Delta-Tabellen in OneLake geschrieben werden. Das Delta-Format ist das einheitliche Tabellenformat für alle Computemodule in Microsoft Fabric. Die OneLake-Integration exportiert die Daten mit allen wichtigen Leistungsfeatures, die einen nahtloseren Datenzugriff mit höherer Leistung ermöglichen.

Data Scientists, Datenbankanalysten, App-Entwickler, Dateningenieure und andere Datenconsumer können dann auf dieselben Daten zugreifen, die Ihre Business Intelligence und Finanzberichte in Power BI fördern. T-SQL,Python, Scala, PySpark, Spark SQL, R und No-Code/Low-Code-Lösungen können alle zum Abfragen von Daten aus Delta-Tabellen verwendet werden.

Diagram of OneLake integration for semantic models

Bevor Sie eine OneLake-Integrationslösung in Ihrer Organisation implementieren, lesen Sie die Überlegungen und Einschränkungen weiter unten in diesem Artikel.

Voraussetzungen

Die OneLake-Integration für Semantikmodelle wird nur für Power BI Premium P- und Microsoft Fabric F-SKUs unterstützt. Es wird nicht für Power BI Pro-, Premium-Einzelbenutzer- (Premium Per User, PPU) oder Power BI Embedded A/EM-SKUs unterstützt.

Bevor Sie die OneLake-Integration aktivieren, benötigen Sie Folgendes:

Berechtigungen

Für das Modell ist die Rolle Mitwirkender (Lese-, Schreib-, Erkundungsberechtigungen) erforderlich, um auf den Inhalt eines Modellordners zuzugreifen und Verknüpfungen mit dem Ordner im Lakehouse-Explorer zu erstellen.

Aktivieren der OneLake-Integration

Erweitern Sie in ihren Semantikmodelleinstellungen die OneLake-Integration, stellen Sie den Schieberegler auf Ein, und wählen Sie dann Übernehmen aus.

Enable OneLake integration in model settings.

Verwaltungsportal

Globale und Mandantenadministrator*innen können die OneLake-Integration mithilfe der folgenden Einstellungen im Power BI-Verwaltungsportal steuern:

Screenshot of tenant settings for admin portal.

  • Semantikmodelle können Daten in OneLake exportieren: Ermöglicht die OneLake-Integration auf Organisationsebene. Wenn diese Option deaktiviert ist, können Benutzer die OneLake-Integration für ihre semantischen Modelle nicht aktivieren, und sämtliche semantische Modelle, die derzeit für die OneLake-Integration konfiguriert sind, beenden den Export von Importtabellen in OneLake. Die OneLake-Integration ist standardmäßig für die gesamte Organisation aktiviert.

  • Benutzer*innen können Semantikmodelltabellen in OneLake speichern: Ermöglicht es allen oder ausgewählten Benutzer*innen in der Organisation, die OneLake-Integration für ihre Semantikmodelle zu konfigurieren. Wenn diese Option für bestimmte Benutzer*innen deaktiviert ist, können sie die OneLake-Integration nicht mehr aktivieren. Alle semantischen Modelle, die sie bereits für die OneLake-Integration konfiguriert haben, exportieren jedoch weiterhin Importtabellen in OneLake. Solche Benutzer*innen können die OneLake-Integration für semantische Modelle deaktivieren, die bereits für die OneLake-Integration konfiguriert sind. Sie können die OneLake-Integration jedoch nicht erneut aktivieren. Diese Einstellung erfordert, dass die Mandanteneinstellung Semantikmodelle können Daten nach OneLake exportieren aktiviert ist. Standardmäßig können alle Benutzer*innen in der Organisation die OneLake-Integration für ihre semantischen Modelle konfigurieren.

Aktualisieren des Modells

Damit Modellimportdaten in eine Delta-Tabelle in OneLake geschrieben werden können, muss mindestens eine manuelle oder geplante Aktualisierung für das Modell ausgeführt werden. Führen Sie entweder eine manuelle Aktualisierung aus, oder warten Sie auf eine geplante Aktualisierung.

Exportieren von OneLake-Delta-Tabellen

Delta-Tabellen können auf viele Arten exportiert werden. Wenn ihr Semantikmodell den XMLA-Lese-/Schreibmodus aktiviert hat, können Sie programmgesteuert mit dem Tabellenobjektmodell (TOM) und der Skriptsprache für tabellarische Modelle (TMSL) exportieren.

Sie können z. B. SQL Server Management Studio (SSMS) verwenden, um den folgenden TMSL-Befehl auszuführen:

{  
 "export": {  
   "layout": "delta",
   "type": "full",  
   "objects": [  
     {  
       "database": "<database name>"  
     }  
   ]  
 }  
}

Durchsuchen von Exportdateien

Nach dem Exportieren können Sie den OneLake-Datei-Explorer, der OneLake in Windows Explorer integriert, verwenden, um nach Delta-Tabellenexportdateien zu suchen.

  1. Klicken Sie im OneLake-Datei-Explorer mit der rechten Maustaste auf den Arbeitsbereichsordner, und wählen Sie dann Sync from OneLake (Aus OneLake synchronisieren) aus.

  2. Verwenden Sie Windows Explorer, um Ihre Datendateien zu suchen. Suchen Sie im Arbeitsbereichsordner nach einem Unterordner mit einem Namen, der Ihrem Semantikmodell entspricht und mit .SemanticModel endet. Der Semantikmodellordner enthält jede Importmodustabelle in einem Unterordner, der die Parquet-Dateien und das Protokoll der Delta-Tabelle enthält.

    TMSL export command in SSMS.

Verknüpfungen

Indem Sie Verknüpfungen für Ihre Lakehouse-Semantikmodelltabellen erstellen, können Sie schnell und einfach von anderen Workloads in Fabric darauf zugreifen.

  1. Klicken Sie im Lakehouse-Explorer mit der rechten Maustaste auf Tabellen, und wählen Sie dann Neue Verknüpfung aus.

  2. Wählen Sie im Dialogfeld Neue Verknüpfung die Option Microsoft OneLake aus.

  3. Wählen Sie unter Datenquellentyp auswählen Ihr Semantikmodell und dann die Tabellen aus, die Sie einbeziehen möchten.

    OneLake shortcuts in Explorer

Überlegungen und Einschränkungen

  • Während der Vorschau können Währungsdatentypen mit Werten, die größer als 18 Dezimalstellen sind, beim Exportieren in Delta-Dateien einige Genauigkeitsverluste aufweisen.

  • Während der Vorschau werden Semantikmodelle in Arbeitsbereichen mit BYOKAktivierung nicht unterstützt.

  • Während der Vorschau können Verknüpfungstabellen, die auf dem exportierten Modell in Lakehouse basieren, nicht mithilfe des SQL-Endpunkts abgefragt werden.

  • Während der Vorschau werden Multi-Geo-Kapazitäten noch nicht unterstützt.

  • Während der Vorschau wird der Vorgang des Exportierens des Modells nach OneLake nicht in Rechnung gestellt, aber Compute- und Speichernutzung des exportierten Modells bei OneLake werden in Rechnung gestellt.

  • Für Benutzer*innen, die Mitwirkender-Berechtigungen für exportierte Modelltabellen, jedoch nur Berechtigungen des Typs Anzeigender Benutzer für den Arbeitsbereich besitzen, wird ein Modellordner im Lakehouse-Explorer angezeigt, aber bei Auswahl wird ein Fehler zurückgegeben.

  • Measures, DirectQuery-Tabellen, Hybridtabellen, Berechnungsgruppentabellen und vom System verwaltete Aggregationstabellen können nicht in Tabellen im Delta-Format exportiert werden.

  • Es wird nur eine einzelne Version der Delta-Tabellen exportiert und auf OneLake gespeichert. Alte Versionen der Delta-Tabellen werden nach einem erfolgreichen Export gelöscht. Andere Ausführungsmodule, die die ältere, aber jetzt gelöschte Version der Daten verwenden, können vorübergehende Fehler aufweisen.

Zugehöriger Inhalt