Partage via


Utiliser l’historique des versions du modèle sémantique (préversion)

Power BI configure automatiquement l’historique des versions de modèle sémantique pour les modèles sémantiques Premium modifiés sur le web. Avec l’historique des versions, les utilisateurs en libre-service peuvent récupérer des erreurs les plus critiques lors de la modification de leurs modèles sémantiques sur le web. Pour le contrôle de code source complet et la prise en charge d’autres versions, utilisez d’intégration Git, qui peut être utilisée en combinaison avec l’historique des versions pour le même modèle sémantique.

Ouvrir le volet Historique des versions

Vous pouvez afficher les versions précédentes d’un modèle sémantique à l’aide d’un volet d’historique des versions de type Office. L’ouverture du volet d’historique des versions peut être effectuée à partir de plusieurs emplacements et de différentes façons, chacun ayant le même résultat :

  • Dans la liste de contenu de l’espace de travail, sélectionnez Autres options (...) pour le modèle sémantique, puis sélectionnez historique des versions.

    Capture d’écran montrant comment sélectionner l’historique des versions dans un menu de modèle sémantique.

  • Dans la liste de contenu du catalogue OneLake, sélectionnez Autres options (...) pour le modèle sémantique, puis sélectionnez historique des versions.

    Capture d’écran montrant comment sélectionner l’historique des versions dans la liste de contenu du catalogue OneLake.

  • Depuis la page des détails du modèle sémantique, sélectionnez fichier et ensuite sélectionnez historique des versions.

    Capture d’écran montrant comment sélectionner l’historique des versions dans le menu Fichier.

  • Lors de la modification d’un modèle sémantique sur le web, sélectionnez fichier, puis historique des versions.

    Capture d’écran montrant comment sélectionner l’historique des versions lors de la modification d’un modèle sémantique sur le web.

  • Lors de la modification d’un modèle sémantique sur le web, sélectionnez la barre de titre du modèle sémantique, puis sélectionnez Historique des versions.

    Capture d’écran montrant comment sélectionner l’historique des versions lors de la modification d’un modèle sémantique sur le web à partir de la barre de titre.

Afficher le volet Historique des versions

Dans le volet historique des versions, vous pouvez voir jusqu’à cinq versions par modèle sémantique. Chacune des versions du volet d’historique des versions stocke les métadonnées et les données du modèle sémantique. Chaque version répertoriée dans le volet affiche les informations suivantes sur la version :

  • Horodatage de la dernière modification apportée au modèle sémantique capturé dans la version.
  • Nom de la personne qui a apporté la dernière modification au modèle sémantique capturé dans la version.
  • Description de la version, si elle est fournie précédemment par un utilisateur lors de l’enregistrement manuel de la version.

Capture d’écran montrant le volet Historique des versions.

Enregistrer une version dans l’historique des versions

Les versions d’un modèle sémantique commencent à être capturées après son ouverture en mode Édition sur le web ou lors de l’ouverture d’un modèle Direct Lake pour la modification dynamique dans Power BI Desktop.

Chaque modèle sémantique qui prend en charge l’historique des versions peut avoir jusqu’à cinq versions enregistrées. Une version est enregistrée dans l’historique des versions chaque fois que l’une des actions suivantes se produit :

  • Lorsque vous enregistrez manuellement une version dans l’historique des versions. Pour modifier un modèle sémantique sur le web, sélectionnez Fichier , puis sélectionnez Enregistrer dans l’historique des versions .

    Capture d’écran montrant comment enregistrer manuellement l’historique des versions dans le menu Fichier.

    Lorsque vous enregistrez manuellement une version, vous pouvez éventuellement fournir une description textuelle pour vous aider à identifier cette version ultérieurement dans le volet historique des versions.

    Capture d’écran montrant comment ajouter manuellement une description à une version.

    La description s’affiche avec sa version correspondante dans le volet d’historique des versions.

    Capture d’écran montrant la description fournie avec une version.

  • Lorsque vous publiez un fichier .pbix depuis Power BI Desktop ou chargez un fichier .pbix sur le web, une version du modèle sémantique, avant la publication ou le chargement, est capturée. La capture automatique de la version garantit que si vous remplacez involontairement les modifications que vous avez apportées sur le web lors de la publication ou du chargement, vous pouvez restaurer le modèle à son état ou à sa version antérieure, avant que cette publication ou ce chargement involontaire ne se produise.

  • Lorsque vous ouvrez votre modèle sémantique sur le web en mode édition une version du modèle sémantique est capturée, en vous assurant que si vous apportez des modifications non souhaitées dans votre session d’édition web, vous pouvez restaurer le modèle à son état ou version avant que ces modifications n’aient été apportées.

  • Lorsque vous restaurez votre modèle sémantique vers une version précédente à partir de l’historique des versions, une version du modèle avant l’enregistrement de la restauration vous permet de restaurer à l’état avant la restauration si une version non souhaitée a été sélectionnée.

Restaurer vers une version précédente

Pour restaurer un modèle sémantique vers une version précédente, dans le volet historique des versions, sélectionnez Restaurer dans le menu contextuel de la version que vous souhaitez restaurer.

Capture d’écran montrant comment restaurer une version précédente d’un modèle sémantique à partir du volet Historique des versions.

Le volet Historique des versions affiche également une entrée pour la version actuelle du modèle. Vous ne pouvez pas restaurer votre version actuelle. Par conséquent, le menu contextuel de votre version actuelle offre la possibilité d’ouvrir le modèle sémantique sur le web.

Capture d’écran montrant le menu contextuel d’une version de modèle sémantique actuelle à partir du volet Historique des versions.

Afficher les journaux d’audit et les événements d’activité

Les administrateurs Power BI peuvent utiliser le Centre d’administration Microsoft 365 pour auditer les opérations relatives à la restauration et à l’enregistrement des versions dans l’historique des versions du modèle sémantique. Les tableaux suivants indiquent les opérations d’audit prises en charge pour l’historique des versions du modèle sémantique :

Nom convivial Nom de l’opération Notes
Restaurer un modèle à une version antérieure RestorePreviousVersionForPowerBIModel Un utilisateur restaure un modèle sémantique Power BI vers une version précédente enregistrée dans l’historique des versions.
Enregistrement d’une nouvelle version dans l’historique des versions d’un modèle dans Power BI SaveNewVersionForPowerBIModel Une nouvelle version est enregistrée pour l’historique des versions d’un modèle sémantique Power BI.

Pour plus d’informations sur l’accès aux journaux d’audit, consultez l’article Accéder à vos journaux d’audit.

Utilisation de la capacité et création de rapports

Vous pouvez surveiller l'effet que la restauration d'une version précédente a sur vos capacités Power BI Premium à l'aide de l'application de métriques Premium. L’effet de capacité peut être surveillé à l’aide de l’opération suivante .

Opération Description Charge de travail Type
Écriture de modélisation web Opération d’écriture de modèle de données dans l’expérience utilisateur de modélisation web du modèle sémantique Modèles sémantiques Interactif

Il n’existe aucun frais supplémentaire pour le stockage utilisé pour capturer les versions dans l’historique des versions du modèle sémantique pour vos modèles.

Conditions requises et autorisations

  • Les utilisateurs doivent disposer de l'autorisation Écrire et Générer sur le modèle sémantique pour afficher et utiliser l'historique des versions. Pour en savoir plus, consultez l’article sur les autorisations.
  • La fonctionnalité d’historique des versions n’est pas disponible pour les utilisateurs disposant d’une licence gratuite.

Considérations et limitations

L’historique des versions du modèle sémantique est actuellement en préversion. Gardez à l’esprit les éléments suivants :

  • Jusqu’à cinq versions sont enregistrées par modèle. L’enregistrement des versions après avoir atteint la limite de cinq versions remplacera la version la plus ancienne dans l’historique des versions.
  • Le modèle sémantique doit se trouver dans un espace de travail Premium.
  • L’historique des versions n’est pas pris en charge pour les modèles sémantiques stockés dans Mon espace de travail.
  • Le modèle sémantique doit d’abord être ouvert sur le web ou ouvert pour la modification dynamique de Direct Lake dans Power BI Desktop avant que les versions ne commencent à être capturées pour le modèle.
  • Vous ne pouvez pas apporter de modifications à votre modèle sémantique lorsque le modèle est restauré dans une version précédente.
  • Vous ne pouvez pas supprimer une version dans l’historique des versions d’un modèle sémantique.
  • L’historique des versions du modèle sémantique est soumis aux mêmes limitations que modification de modèles de données dans le service Power BI.
  • L’historique des versions ne sera pas capturé pour les modèles sémantiques qui n’ont pas encore été mis à niveau vers format de métadonnées amélioré. En outre, si un modèle avec l’ancien format de métadonnées est publié sur un modèle au format de métadonnées amélioré, toutes les versions de modèle sémantique précédemment capturées pour ce modèle seront supprimées.
  • Le déplacement d’un modèle entre les capacités supprime son historique des versions.
  • Vous ne pouvez pas accéder aux versions dans l’historique des versions du modèle sémantique en dehors du volet historique des versions sur le web. Pour un contrôle de code source complet avec une plus grande flexibilité et une prise en charge d’autres versions, utilisez d’intégration Git, qui peut être utilisée en combinaison avec l’historique des versions pour le même modèle sémantique.
  • Les données de votre modèle sémantique peuvent devenir obsolètes après la restauration vers une version précédente. Pour vous assurer que vous disposez des données les plus récentes, effectuez une actualisation après avoir effectué une restauration. Le comportement d’actualisation peut varier selon les modes de stockage. Par exemple, les modèles Direct Lake avec mises à jour automatiques configurées seront automatiquement mis à jour avec les données les plus récentes après une restauration, sans que vous deviez lancer manuellement une actualisation.
  • Le modèle sémantique doit avoir le format de stockage de modèle sémantique volumineux activé. Les modèles sémantiques sont automatiquement convertis en format de stockage de modèle sémantique volumineux la première fois qu’ils sont ouverts en mode Édition sur le web ou lors de l’ouverture d’un modèle Direct Lake pour la modification dynamique dans Desktop. Si un modèle sémantique avec les versions capturées dans l’historique des versions a le format de stockage de modèle sémantique volumineux désactivé dans les paramètres du modèle, l’historique des versions de ce modèle est supprimé. Un avertissement dans les paramètres du modèle sémantique vous informe de cet impact avant d’apporter la modification : Capture d’écran montrant un avertissement sur la suppression de l’historique des versions.

Cet article a fourni des informations sur la préversion des versions de modèle sémantique. Pour plus d’informations sur la modélisation des données dans Power BI, consultez les ressources suivantes :