Partager via

Créer des règles de déploiement

Lorsque vous travaillez dans un pipeline de déploiement, les différentes phases pourraient avoir des configurations différentes. Par exemple, chaque étape peut avoir des bases de données différentes ou des paramètres de requête différents. L’étape de développement peut interroger des exemples de données de la base de données, tandis que les étapes de test et de production interrogent la base de données entière.

Lorsque vous déployez du contenu entre les phases du pipeline, vous pouvez configurer des règles de déploiement pour modifier le contenu tout en conservant certains paramètres intacts. Par exemple, vous pouvez définir une règle de modèle sémantique dans une étape de production pour qu’elle référence une base de données de production au lieu d’une base de données dans l’étape de test. La règle se définit dans la phase de production, sous le modèle sémantique approprié. Une fois la règle définie, le contenu déployé à partir du test vers la production hérite de la valeur définie dans la règle de déploiement. Cette règle s’applique toujours tant qu’elle est inchangée et valide.

Remarque

La nouvelle interface utilisateur du pipeline de déploiement est actuellement en préversion . Pour activer ou utiliser la nouvelle interface utilisateur, consultez Commencer à utiliser la nouvelle interface utilisateur.

Vous pouvez configurer des règles de source de données, de paramètre et des règles de lakehouse par défaut. Le tableau suivant répertorie les types d'éléments pour lesquels vous pouvez configurer des règles et le type de règle que vous pouvez configurer pour chacun.

Élément Règle de source de données Règle de paramètre Règle par défaut du Lakehouse Détails
Dataflow gen1 ✅ ✅ ❌ Permet de déterminer les valeurs des sources de données ou des paramètres d’un dataflow gen1 spécifique.
Modèle sémantique ✅ ✅ ❌ Permet de déterminer les valeurs des sources de données ou des paramètres d’un modèle sémantique spécifique.
Datamart ✅ ✅ ❌ Permet de déterminer les valeurs des sources de données ou des paramètres pour un datamart spécifique.
Rapport avec pagination ✅ ❌ ❌ Défini pour les sources de données de chaque rapport paginé. À utiliser afin de déterminer les sources de données du rapport paginé.
Base de données en miroir ✅ ❌ ❌ Défini pour les sources de données de chaque base de données mise en miroir.
Notebook ❌ ❌ ✅ Utilisez-le pour déterminer le lakehouse par défaut pour un notebook spécifique.

Remarque

Les règles de source de données fonctionnent uniquement quand vous changez des sources de données du même type.

Créer une règle de déploiement

Pour créer une règle de déploiement, suivez les étapes décrites dans cette section. Après avoir créé toutes les règles de déploiement dont vous avez besoin, déployez les modèles sémantiques avec les nouvelles règles de l’étape source vers l’étape cible où les règles ont été créées. Vos règles ne sont pas appliquées tant que vous ne déployez pas les modèles sémantiques de l’étape source vers l’étape cible.

  1. Dans la phase de pipeline pour laquelle vous souhaitez créer une règle de déploiement, sélectionnez Règles de déploiement.

    Capture d’écran du bouton Règles de déploiement, situé dans le menu de l’étape de déploiement.

  2. Une liste d’éléments pour laquelle vous pouvez définir des règles apparaît dans la fenêtre. Tous les éléments du pipeline ne sont pas répertoriés. Seuls les éléments d'un type dont vous pouvez créer des règles sont répertoriés (dataflows gen1, modèle sémantique, datamarts, notebooks et rapports paginés). Pour trouver l’élément pour lequel vous souhaitez définir une règle, utilisez les fonctionnalités de recherche ou de filtrage.

    Capture d’écran du volet Règles de déploiement dans la nouvelle interface utilisateur, montrant que vous pouvez définir des règles pour les dataflows gen1, les jeux de données, les datamarts et les rapports paginés.

  3. Sélectionnez l’élément pour lequel vous souhaitez créer une règle. Les types de règles que vous pouvez créer pour cet élément sont affichés. Par exemple, si vous créez une règle pour un dataflow gen1, vous pouvez créer une règle de source de données ou une règle de paramètre. Si vous créez une règle pour un bloc-notes, vous pouvez créer une règle Lakehouse par défaut.

  4. Sélectionnez le type de règle que vous souhaitez créer, développez la liste, puis sélectionnez Ajouter une règle. Il existe deux types de règles que vous pouvez créer :

    Capture d’écran du nouveau volet des règles de déploiement. Il affiche un jeu de données sélectionné et les deux types de règles, la source de données et le paramètre, que vous pouvez configurer pour celui-ci.

    • Règles de source de données

      Dans la liste des sources de données, sélectionnez un nom de source de données à mettre à jour. Utilisez l’une des méthodes suivantes pour sélectionner une valeur afin de remplacer celle de l’étape source :

      • Sélectionnez dans une liste.

      • Sélectionnez Autre et ajoutez manuellement la nouvelle source de données. Vous pouvez uniquement modifier une source de données du même type.

      Remarque

      • Les règles de source de données seront grisées si vous n'êtes pas le propriétaire de l'élément pour lequel vous créez une règle ou si votre élément ne contient aucune source de données.
      • Pour les flux de données gen1, lesmodèles sémantiques et les rapports paginés, la liste des sources de données est extraite de l’étape de la canalisation source.
      • Vous ne pouvez pas utiliser la même source de données dans plus d’une règle.

    • Règles de paramètres : sélectionnez un paramètre dans la liste des paramètres ; la valeur actuelle est affichée. Modifiez la valeur en lui affectant la valeur que vous souhaitez appliquer après chaque déploiement.

    • Règles par défaut du Lakehouse Cette règle s'applique uniquement aux notebooks. Sélectionnez un lakehouse pour vous connecter au notebook dans l'étape cible et définissez-le comme valeur par défaut. Pour plus d'informations, consultez Notebook dans les pipelines de déploiement.

Sources de données prises en charge pour dataflow gen1 et règles de modèle sémantique

Les règles de source de données peuvent être définies pour les sources de données suivantes :

  • Azure Analysis Services (AAS)
  • Azure Synapse
  • SQL Server Analysis Services (SSAS)
  • Azure SQL Server
  • Serveur SQL
  • Flux OData
  • Oracle
  • SapHana (mode importation uniquement ; pas en mode de requête directe)
  • SharePoint
  • Teradata

Pour les autres sources de données, nous vous recommandons d’utiliser des paramètres pour configurer votre source de données.

Considérations et limitations

Cette section répertorie les limitations appliquées aux règles de déploiement.

  • Pour créer une règle de déploiement, vous devez être le propriétaire de l'élément pour lequel vous créez une règle de déploiement.

  • Il est impossible de créer des règles de déploiement en phase de développement.

  • Lorsqu’un élément est retiré ou supprimé, ses règles sont également supprimées. Ces règles ne peuvent pas être restaurées.

  • Quand vous désattribuez et réattribuez un espace de travail pour rétablir les connexions, les règles de cet espace de travail sont perdues. Pour utiliser ces règles à nouveau, vous devez les reconfigurer.

  • Si la source de données ou le paramètre défini dans une règle est modifié ou supprimé de l'élément vers lequel il pointe dans l'étape source, la règle n'est plus valide et le déploiement échoue.

  • Après avoir déployé un rapport paginé avec une règle de source de données, vous ne pouvez pas ouvrir le rapport à l’aide du Générateur de rapports Power BI.

  • Les règles de déploiement ne prennent effet que la prochaine fois que vous effectuez un déploiement à cette étape. Toutefois, si vous créez des règles et comparez ensuite les étapes avant le déploiement, la comparaison est effectuée sur la base des règles créées, même si elles n'ont pas encore pris effet.

  • Les scénarios suivants ne sont pas pris en charge :

    • Règles de source de données pour les dataflows gen1 qui ont d’autres dataflows en tant que sources.
    • Règles de source de données pour les dossiers CDM (Common Data Model) dans un dataflow gen1.
    • Règles de source de données pour les modèles sémantiques qui utilisent des dataflows gen1 comme source.
    • La création de règles de source de données sur un modèle sémantique qui utilise une requête native et DirectQuery ensemble.
    • Les règles de paramètres ne sont pas prises en charge pour les rapports paginés.
    • Ajout de règles de source de données pour les modèles sémantiques et les dataflows gen1 sur les sources de données qui sont paramétrées.

Contenu connexe

  • Last updated on