Utiliser des paramètres publics dans Dataflow Gen2

Conseil / Astuce

Pour plus d’informations sur l’utilisation de cette fonctionnalité dans les scénarios d’intégration continue/de déploiement continu (CI/CD), lisez l’article sur les architectures de solution CI/CD et ALM pour Dataflow Gen2 et le didacticiel de bout en bout sur le flux de données paramétrable Gen2.

Les paramètres dans Dataflow Gen2 vous permettent de contrôler et personnaliser dynamiquement les flux de données, ce qui les rend plus flexibles et réutilisables en activant différentes entrées et scénarios sans modifier le flux de données lui-même. Il permet de garder les choses organisées en réduisant la nécessité de plusieurs flux de données et de centraliser le contrôle au sein d’un dataflow paramétrable unique.

Les paramètres publics dans Dataflow Gen2 sont un nouveau mode dans lequel vous pouvez autoriser l’exécution de votre dataflow en passant des valeurs de paramètre en dehors de l’éditeur Power Query via l’API REST Fabric ou par le biais d’expériences Fabric natives. Il vous permet d’avoir une expérience plus dynamique avec votre dataflow où chaque exécution peut être appelée avec différents paramètres qui affectent la façon dont votre dataflow s’exécute.

Conditions préalables

• Un Dataflow Gen2 avec prise en charge de CI/CD
• Les paramètres doivent être définis dans votre dataflow.Découvrez comment définir des paramètres de requête dans Dataflow.

Activer le mode de paramètre public

En tant que propriétaire du flux de données, ouvrez le flux de données. Dans l’onglet Accueil du ruban, sélectionnez le bouton Options .

La sélection du bouton ouvre une nouvelle boîte de dialogue Options . Dans le menu vertical, sélectionnez l’option avec l'étiquette Paramètres dans le groupe dataflow. Dans la section Paramètres, vous pouvez activer l’option qui lit « Activer les paramètres à découvrir et remplacer pour l’exécution » pour activer le mode des paramètres publics.

Sélectionnez le bouton OK pour valider ces modifications.

Lorsque ce mode est activé, vous recevez une notification dans la boîte de dialogue Gérer les paramètres qui lit « Le mode paramètre public est activé » en haut de la boîte de dialogue.

Une fois le mode de paramètre public activé, vous pouvez enregistrer votre dataflow.

Passer des valeurs de paramètre personnalisées pour les exécutions de dataflow

Le mode de paramètre public suit la définition des paramètres à l’intérieur du flux de données où il existe une distinction entre les paramètres obligatoires et non requis.

• Paramètres obligatoires : si un paramètre est défini comme requis, pour exécuter le flux de données, une valeur doit être passée au travail d’exécution. L’exécution échoue si aucune valeur n’est passée pour un paramètre défini sur obligatoire.
• Paramètres non obligatoires : ils sont également appelés paramètres facultatifs et aucune valeur n’est nécessaire pour qu’une exécution soit déclenchée. Si aucune valeur n’est passée, la valeur actuelle définie dans votre paramètre est utilisée pour l’exécution.

Utiliser l’activité Flux de données dans les Pipelines

Remarque

Nous vous recommandons de lire plus en détail l’activité de flux de données à partir de pipelines Fabric pour comprendre toutes ses fonctionnalités.

Lorsque vous créez un pipeline dans Fabric, vous pouvez utiliser l’activité de flux de données pour déclencher l’exécution d’un Dataflow Gen2 avec prise en charge CI/CD pour laquelle le mode de paramètres publics est activé.

Vous pouvez sélectionner le flux de données que vous souhaitez utiliser et définir les paramètres que vous souhaitez utiliser dans la section paramètres de dataflow .

Dans la section Paramètres du flux de données, vous pouvez voir tous les paramètres disponibles dans votre dataflow et la valeur par défaut de chaque élément de la section valeur.

Les paramètres obligatoires ont un astérisque en regard de leur nom, tandis que les paramètres facultatifs ne le sont pas. En même temps, les paramètres facultatifs peuvent être supprimés de la grille, tandis que les paramètres requis ne peuvent pas être supprimés et qu’une valeur doit être passée pour que le flux de données s’exécute.

Vous pouvez sélectionner le bouton Actualiser pour demander les dernières informations de paramètre à partir de votre dataflow.

Types de paramètres pris en charge

Conseil / Astuce

Lisez et utilisez l’API REST des paramètres Dataflow de Discover. La documentation fournit tous les types de paramètres disponibles et leurs valeurs attendues, et l’API REST permet d’obtenir les informations de paramètre à partir de votre dataflow.

Le tableau suivant présente les types de paramètres actuellement pris en charge et le lien vers la définition de l’API REST pour qu’il comprenne les valeurs attendues par l’API REST.

Type de paramètre de flux de données	Définition de l’API REST
Texto	DataflowStringParameter
Entier (int64)	DataflowIntegerParameter
Nombre décimal	DataflowNumberParameter
Date	DataflowDateParameter
Date et heure	DataflowDateTimeParameter
Heure	DataflowTimeParameter
DateTimeZone	DataflowDateTimeZoneParameter
Durée	DataflowDurationParameter
Vrai/Faux	DataflowBooleanParameter

Considérations et limitations

Voici une liste de toutes les considérations et limitations relatives à l’utilisation du mode de paramètres publics dans Dataflow Gen2 avec CI/CD :

• Planification et déclenchement manuel : les flux de données avec des paramètres publics ne peuvent pas être planifiés ou déclenchés manuellement via Fabric, sauf si aucun paramètre requis n’est défini.
• Paramétrage non pris en charge : les paramètres qui modifient les chemins d’accès aux ressources pour les sources ou les destinations ne sont pas pris en charge. Les connexions sont attachées au chemin créé.
• Actualisation incrémentielle : non compatible avec le mode paramètres publics.
• Modification logique : les paramètres publics permettent aux utilisateurs d’accéder à des valeurs de remplacement, ce qui peut changer la sortie du flux de données.
• Hub de supervision : le hub de supervision n’affiche pas les valeurs de paramètre utilisées pendant l’exécution.
• Comportement intermédiaire : seule la dernière exécution est stockée dans Staging Lakehouse. Utilisez des destinations définies pour conserver les données.
• Demandes en double : si les mêmes valeurs de paramètre sont envoyées plusieurs fois, seule la première demande est acceptée jusqu’à ce qu’elle se termine.
• Mappage de Schéma : les paramètres ne peuvent pas modifier les mappages de schémas de destination. Tous les mappages suivent la configuration créée. Consultez l’article pour plus d’informations sur les destinations de données et les paramètres managés dans Dataflow Gen2.