Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Note
L’éditeur d’expressions dynamiques pour les destinations de données est actuellement en aperçu.
L’éditeur d’expressions dynamiques vous aide à construire des valeurs dans les champs de destination de données pris en charge en combinant du texte avec des valeurs qui se résolvent lors de l’exécution du flux de données. Par exemple, vous pouvez inclure la date de rafraîchissement UTC dans un nom de fichier, utiliser un paramètre pour un nom de table, ou inclure une valeur spécifique à l’espace de travail.
L’éditeur est activé par défaut. Lorsque vous l’utilisez pour la première fois, un appel d’enseignement explique comment ouvrir le menu de valeurs dynamiques.
Valeurs disponibles
Les valeurs disponibles dans l’éditeur dépendent du flux de données et de la configuration de l’espace de travail.
| Category | Description |
|---|---|
| Valeurs dynamiques | Valeurs UTC de date et d’heure pour l’exécution de flux de données.
Date utilise yyyyMMdd, Heure utilise HHmmss, et Date/Heure utilise yyyyMMddHHmmss. Par exemple, une valeur Date/Heure peut se résoudre au 20201230232459 30 décembre 2020 à 23:24:59 UTC. |
| Paramètres | Les paramètres que vous définissez dans le flux de données. Sélectionnez Gérer les paramètres dans le menu pour créer ou modifier les paramètres. |
| Variables d’espace de travail | Valeurs intégrées à l’espace de travail, telles que currentWorkspaceId, et valeurs issues des éléments de la Fabric Variable Library disponibles dans le flux de données. |
Créez un nom de tableau ou de fichier dynamique
Dans l’éditeur Power Query, ajoutez une destination de données à une requête.
Placez le curseur dans un champ de destination qui prend en charge les expressions dynamiques, telles que Nom de table ou Nom de fichier.
Saisissez tout texte qui devrait rester le même à chaque exécution du flux de données.
Appuyez
/pour ouvrir le menu de valeurs dynamiques.
Sélectionnez une valeur dynamique, un paramètre ou une variable d’espace de travail. Vous pouvez aussi commencer à taper après
/pour filtrer le menu.Continuez à saisir le texte et les valeurs jusqu’à la fin de l’expression. Pour une destination de fichier, incluez l’extension de fichier comme texte.
Terminez la configuration de la destination des données, puis publiez le flux de données.
À l’exécution, Dataflow Gen2 résout chaque jeton et combine les valeurs avec le texte de l’expression. Le comportement normal de destination s’applique toujours au nom résultant. Par exemple, une destination de fichier peut écraser un fichier lorsque le nom du fichier résolu correspond à un fichier existant.
Modifier une expression
Vous pouvez modifier le texte et insérer plus de valeurs n’importe où dans l’expression.
- Pour ouvrir le menu sans utiliser la souris, appuyez sur
/. Utilisez les touches flèches pour naviguer dans le menu, puis appuyez sur Entrée pour insérer la valeur sélectionnée. - Pour fermer le menu sans sélectionner de valeur, appuyez sur Esc. Le
/texte et tout texte que vous avez entré après reste dans le champ en tant que texte. - Pour supprimer une valeur insérée, placez le curseur à côté de son jeton et appuyez sur Retour en arrière ou Supprimer.
Exemples d’expressions
| Scénario | Expression |
|---|---|
| Ajoutez la date et l’heure d’exécution à un nom de fichier | Orders-<Date>-<Time>.csv |
| Utilisez un paramètre dataflow comme préfixe de nom de table | <Environment>_Sales |
| Incluez l’espace de travail actuel dans un nom | Sales_<currentWorkspaceId> |
Dans l’éditeur, les valeurs affichées entre crochets dans ces exemples apparaissent sous forme de jetons. On ne tape pas les crochets d’angle.
Important
Le nom de la table ou du fichier résolu doit suivre les règles de nommage de la destination sélectionnée. Si une valeur dynamique introduit des caractères non pris en charge ou crée un nom invalide, la validation de la destination ou l’exécution du flux de données peut échouer.
Désactivez ou activez l’éditeur d’expressions dynamiques
L’éditeur d’expressions dynamiques est activé par défaut. Votre préférence est stockée dans un cookie de navigateur et n'est pas enregistrée dans le service Fabric. En conséquence, ce paramètre ne se retient pas sur les navigateurs ou appareils et peut revenir à son état par défaut si vous effacez les cookies de votre navigateur. Pour la modifier :
- Dans l’éditeur Power Query, sélectionnez Options depuis l’onglet Accueil.
- Dans la boîte d’Options, sélectionnez Général Global>.
- Faites défiler jusqu’à la section Destinations des données .
- Sous Éditeur, décochez Activer l’éditeur d’expressions dynamiques pour désactiver l’éditeur. Sélectionne la case à cocher pour le réactiver.
- Sélectionnez OK.
Désactiver l’éditeur ne supprime pas les expressions dynamiques déjà configurées.
Considérations et limites
- La disponibilité dépend de la destination et du champ de données sélectionnés.
- L’éditeur combine le texte et les valeurs disponibles. Ce n'est pas un éditeur d'expressions Power Query M généraliste.
- Un paramètre référencé ou une variable d’espace de travail doit être disponible lors de l’exécution du flux de données.
- Changer un paramètre, une variable d’espace de travail, une date ou une valeur d’heure peut entraîner un changement du nom de destination résolu entre les exécutions.
- Pour paramétrer les paramètres de destination qui ne sont pas pris en charge par cet éditeur, voir Édition avancée pour les requêtes de destination de données.