Partager via


Intégration OneLake pour les modèles sémantiques

Important

L’intégration OneLake pour les modèles sémantiques est actuellement en préversion.

Avec l’intégration Microsoft OneLake pour les modèles sémantiques, les données importées dans des tables de modèle peuvent également être écrites automatiquement dans des tables Delta dans OneLake. Le format Delta est le format de table unifié dans tous les moteurs de calcul de Microsoft Fabric. L’intégration OneLake exporte les données avec toutes les fonctionnalités de performances clés activées pour fournir un accès aux données plus fluide et avec des performances plus élevées.

Les scientifiques des données, les analystes de base de données, les développeurs d’applications, les ingénieurs Données et d’autres consommateurs de données peuvent alors accéder aux mêmes données que celles qui alimentent vos rapports financiers et décisionnels dans Power BI. T-SQL, Python, Scala, PySpark, Spark SQL, R et les solutions sans code/à code réduit peuvent tous être utilisés pour interroger des données dans des tables Delta.

Diagram of OneLake integration for semantic models

Avant d’implémenter une solution d’intégration OneLake dans votre organisation, veillez à lire Considérations et limitations plus loin dans cet article.

Prérequis

L’intégration OneLake pour les modèles sémantiques est prise en charge seulement sur les références SKU Power BI Premium P et Microsoft Fabric F. Il n’est pas pris en charge sur Power BI Pro, Premium par utilisateur ou les références SKU Power BI Embedded A/EM.

Avant d’activer l’intégration OneLake, vous devez disposer des éléments suivants :

Autorisations

Les autorisations de contributeur de modèle (lecture, écriture, exploration) sont nécessaires pour accéder au contenu d’un dossier de modèle et pour créer des raccourcis liant au dossier dans l’Explorateur Lakehouse.

Activer l’intégration OneLake

Dans les paramètres de votre modèle sémantique, développez Intégration OneLake, cliquez sur le curseur pour le faire passer sur Activé, puis sélectionnez Appliquer.

Enable OneLake integration in model settings.

Portail d’administration

Les administrateurs généraux et tenants peuvent contrôler l’intégration de OneLake à l’aide des paramètres suivants dans le portail d’administration Power BI :

Screenshot of tenant settings for admin portal.

  • Les modèles sémantiques peuvent exporter des données vers OneLake : permet d’intégrer OneLake au niveau de l’organisation. Si cette option est désactivée, les utilisateurs ne peuvent pas activer l’intégration de OneLake pour leurs modèles sémantiques, et tous les modèles sémantiques actuellement configurés pour l’intégration OneLake arrêtent l’exportation des tables d’importation vers OneLake. L’intégration de OneLake est activée par défaut pour l’ensemble de l’organisation.

  • Les utilisateurs peuvent stocker des tables de modèles sémantiques dans OneLake : permet à tous ou à certains utilisateurs de l’organisation de configurer l’intégration de OneLake pour leurs modèles sémantiques. Si cette option est désactivée pour un utilisateur spécifique, cet utilisateur ne peut plus activer l’intégration de OneLake, mais tous les modèles sémantiques déjà configurés pour l’intégration de OneLake continuent d’exporter des tables d’importation vers OneLake. Cet utilisateur peut désactiver l’intégration de OneLake pour les modèles sémantiques déjà configurés pour l’intégration de OneLake, mais ne peut pas réactiver l’intégration de OneLake. Le paramètre nécessite que le paramètre de locataire Les modèles sémantiques peuvent exporter des données vers OneLake soit activé. Par défaut, tous les utilisateurs de l’organisation peuvent configurer l’intégration de OneLake pour leurs modèles sémantiques.

Actualiser le modèle

Pour que les données d’importation de modèle soient écrites dans une table Delta dans OneLake, au moins une actualisation manuelle ou planifiée pour le modèle doit être exécutée. Exécutez une actualisation manuelle ou attendez une actualisation planifiée.

Exporter des tables Delta OneLake

Les tables delta peuvent être exportées de plusieurs façons. Si votre modèle sémantique est activé pour le mode de lecture-écriture XMLA, vous pouvez exporter par programmation en utilisant le modèle objet tabulaire (TOM) et le langage TMSL (Tabular Model Scripting Language).

Par exemple, vous pouvez utiliser SQL Server Management Studio (SSMS) pour exécuter la commande TMSL suivante :

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

Explorer les fichiers d’exportation

Après l’exportation, vous pouvez utiliser l’Explorateur de fichiers OneLake, qui intègre OneLake à votre Explorateur de fichiers Windows, pour localiser les fichiers d’exportation de tables Delta.

  1. Dans l’Explorateur de fichiers OneLake, cliquez avec le bouton droit sur le dossier de l’espace de travail, puis sélectionnez Synchroniser à partir de OneLake.

  2. Utilisez l’Explorateur de fichiers Windows pour localiser vos fichiers de données. Dans le dossier de l’espace de travail, recherchez un sous-dossier portant un nom qui correspond à votre modèle sémantique et se terminant par . SemanticModel. Le dossier du modèle sémantique inclut chaque table en mode importation dans un sous-dossier qui contient les fichiers parquet et le journal de la table Delta.

    TMSL export command in SSMS.

Raccourcis

En créant des raccourcis pour les tables de votre modèle sémantique Lakehouse, vous pouvez offrir un accès rapide et facile à celles-ci depuis d’autres charges de travail dans Fabric.

  1. Dans l’Explorateur Lakehouse, cliquez avec le bouton droit sur Tables, puis sélectionnez Nouveau raccourci.

  2. Dans Nouveau raccourci, sélectionnez Microsoft OneLake.

  3. Dans Sélectionner un type de source de données, sélectionnez votre modèle sémantique, puis sélectionnez les tables à inclure.

    OneLake shortcuts in Explorer

Observations et limitations

  • Pendant la phase de préversion, les types de données monétaires avec des valeurs supérieures à 18 décimales peuvent subir une perte de précision lors de l’exportation vers des fichiers Delta.

  • Pendant la phase de préversion, les modèles sémantiques dans des espaces de travail pour lesquels BYOK est activé ne sont pas pris en charge.

  • Pendant la phase de préversion, les tables de raccourcis basées sur le modèle exporté dans Lakehouse ne peuvent pas être interrogées en utilisant le point de terminaison SQL.

  • Pendant la phase de préversion, les capacités multigéographiques ne sont pas encore prises en charge.

  • Pendant la période de préversion, l’exportation du modèle vers OneLake n’est pas facturée. En revanche, l’utilisation du calcul et du stockage du modèle exporté sur OneLake est soumise à des frais.

  • Pour les utilisateurs disposant d’autorisations de contributeur pour les tables de modèle exportées mais ayant seulement des autorisations viewer pour l’espace de travail, un dossier de modèle apparaît dans l’Explorateur Lakehouse mais une erreur est retournée quand elle est sélectionnée.

  • Les mesures, les tables DirectQuery, les tables hybrides, les tables de groupe de calcul et les tables d’agrégation gérées par le système ne peuvent pas être exportées vers des tables au format Delta.

  • Une seule version des tables delta est exportée et stockée sur OneLake. Les anciennes versions des tables delta sont supprimées après une exportation réussie. D’autres moteurs d’exécution qui utilisent l’ancienne version des données qui est maintenant supprimée peuvent subir des défaillances temporaires.