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, si vous souhaitez qu’un modèle sémantique dans une étape de production référence une base de données de production au lieu d’une base de données dans l’étape de test, vous pouvez le spécifier avec une règle. 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é du test en production hérite de la valeur telle qu’elle est définie dans la règle de déploiement et s’applique toujours tant que la règle est inchangée et valide.

Vous pouvez configurer des règles de source de données 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.

Article	Règle de source de données	Règle de paramètre	Règle de lakehouse par défaut	Détails
Le flux de données	✅	✅	❌	À utiliser afin de déterminer les valeurs des sources de données ou des paramètres pour un dataflow 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	✅	✅	❌	À utiliser afin de déterminer les valeurs des sources de données ou des paramètres pour un datamart données spécifique.
Rapport paginé	✅	❌	❌	Définis pour les sources de données de chaque rapport paginé. À utiliser afin de déterminer les sources de données du rapport paginé.
Notebook	❌	❌	✅	À utiliser afin de 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.

   

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 pour lequel vous pouvez créer des règles sont répertoriés (flux de données, 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.

   

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 flux de données, 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 notebook, vous pouvez créer une règle de 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 :

   

   • 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 à partir 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, les modèles sémantiques et les rapports paginés, la liste des sources de données provient de l’étape source du pipeline.
     • 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 de lakehouse par défaut : cette règle s’applique uniquement aux notebooks. Sélectionnez un lakehouse afin de vous connecter au notebook pour progresser vers un niveau 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 les règles des flux de données et des modèles sémantiques

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.

• 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.

• Les règles de source de données pour les flux de données qui ont d'autres flux de données comme sources ne sont pas prises en charge.

• Les règles de source de données pour les dossiers CDM (Common Data Model) dans un flux de données ne sont pas prises en charge.

• Les règles de sources de données pour les modèles sémantiques qui utilisent des flux de données comme source ne sont pas prises en charge.

• Si la source de données ou le paramètre définis dans une règle sont modifiés ou supprimée dans l'élément vers lequel il pointe dans la phase 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.

• 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 n’est pas prise en charge.

Remarque

Les règles de paramètres ne sont pas prises en charge pour les rapports paginés.

Contenu connexe

• Bien démarrer avec les pipelines de déploiement
• Automatiser votre pipeline de déploiement en utilisant des API et DevOps