Gebruik de dynamische expressie-editor voor Dataflow Gen2 databestemmingen (preview)

Opmerking

De dynamische expressie-editor voor databestemmingen is momenteel in preview.

De dynamische expressie-editor helpt je waarden te bouwen in ondersteunde data-bestemmingsvelden door tekst te combineren met waarden die worden opgelost wanneer de dataflow draait. Je kunt bijvoorbeeld de UTC-verversdatum in een bestandsnaam opnemen, een parameter gebruiken voor een tabelnaam, of een werkruimte-specifieke waarde toevoegen.

De editor is standaard ingeschakeld. Wanneer je dit voor het eerst gebruikt, wordt in een uitlegvenster uitgelegd hoe je het menu voor dynamische waarden opent.

Beschikbare waarden

De waarden die in de editor beschikbaar zijn, zijn afhankelijk van de dataflow en de werkruimteconfiguratie.

Category Description
Dynamische waarden UTC-datum- en tijdwaarden voor de dataflow-run. Datum gebruikt yyyyMMdd, Tijd gebruikt HHmmss, en Datum/tijd gebruikt yyyyMMddHHmmss. Een datum-/tijdwaarde kan bijvoorbeeld resulteren in 20201230232459 voor 30 december 2020 om 23:24:59 UTC.
Parameters Parameters die je definieert in de dataflow. Selecteer parameters beheren in het menu om parameters aan te maken of te bewerken.
Werkruimtevariabelen Ingebouwde werkruimtewaarden, zoals currentWorkspaceId, en waarden uit Fabric Variable Library-items die beschikbaar zijn voor de dataflow.

Maak een dynamische tabel of bestandsnaam aan

  1. Voeg in de Power Query-editor een databestemming toe aan een query.

  2. Plaats de cursor in een bestemmingsveld dat dynamische expressies ondersteunt, zoals Tabelnaam of Bestandsnaam.

  3. Voer elke tekst in die elke keer hetzelfde moet blijven wanneer de dataflow draait.

  4. Druk / om het menu met dynamische waarden te openen.

    Screenshot van het dynamische waardemenu geopend in het veld Bestandsnaam. Het menu bevat Datum, Tijd, Datum/Tijd, parameters en werkruimtevariabelen.

  5. Selecteer een dynamische waarde, parameter of werkruimtevariabele. Je kunt ook na / beginnen met typen om het menu te filteren.

  6. Blijf tekst en waarden invoeren totdat de expressie compleet is. Voor een bestandsbestemming vermeld je de bestandsextensie als tekst.

    Screenshot van een dynamische bestandsnaam die tekst combineert met Datum-, Tijd- en Datum/Tijd-tokens.

  7. Maak de databestemming af en publiceer daarna de dataflow.

Tijdens uitvoering lost Dataflow Gen2 elk token op en combineert de waarden met de tekst in de expressie. Normaal bestemmingsgedrag geldt nog steeds voor de resulterende naam. Een bestandsbestemming kan bijvoorbeeld een bestand overschrijven wanneer de naam van het opgeloste bestand overeenkomt met een bestaand bestand.

Bewerk een uitdrukking

Je kunt tekst bewerken en overal in de expressie meer waarden invoegen.

  • Om het menu te openen zonder de muis te gebruiken, druk op /. Gebruik de pijltjestoetsen om door het menu te gaan en druk vervolgens Enter om de geselecteerde waarde in te voegen.
  • Om het menu te sluiten zonder een waarde te selecteren, druk je op Esc. De / en alle tekst die je daarna invoert, blijven in het veld als tekst.
  • Om een ingevoegde waarde te verwijderen, plaats je de cursor naast zijn token en druk je op Backspace of Delete.

Voorbeelden van expressies

Scenario Expression
Voeg de uitvoeringsdatum en -tijd toe aan een bestandsnaam Orders-<Date>-<Time>.csv
Gebruik een dataflowparameter als tabelnaamprefix <Environment>_Sales
Voeg de huidige werkruimte toe aan een naam Sales_<currentWorkspaceId>

In de editor verschijnen de waarden die tussen haakjes in deze voorbeelden worden weergegeven als tokens. Je typt de punthaken niet.

Belangrijk

De opgeloste tabel of bestandsnaam moet voldoen aan de naamgevingsregels van de geselecteerde bestemming. Als een dynamische waarde niet-ondersteunde tekens introduceert of een ongeldige naam creëert, kan bestemmingsvalidatie of de dataflow-uitvoering falen.

Zet de dynamische expressie-editor uit of aan

De dynamische expressie-editor is standaard ingeschakeld. Je voorkeur wordt opgeslagen in een browsercookie en wordt niet opgeslagen in de Fabric-service. Daardoor wordt de instelling niet overgedragen tussen browsers of apparaten en kan het terugkeren naar het standaard als je je browsercookies verwijdert. Ga als volgende te werk om het te wijzigen:

  1. Selecteer in de Power Query-editor Opties vanuit het Home-tabblad.
  2. Selecteer in het Opties-vensterGlobal>General.
  3. Scroll naar het gedeelte Gegevensbestemmingen .
  4. Onder Editor schakel je Dynamische expressie-editor inschakelen uit om de editor uit te schakelen. Selecteer het selectievakje om hem weer aan te zetten.
  5. Kies OK.

Screenshot van het Opties-dialoogvenster met de instelling Dynamische expressie-editor inschakelen geselecteerd onder Data-bestemmingen.

Het uitschakelen van de editor verwijdert geen dynamische expressies die al zijn geconfigureerd.

Overwegingen en beperkingen

  • De beschikbaarheid hangt af van de geselecteerde databestemming en het veld.
  • De editor combineert tekst en beschikbare waarden. Het is geen algemene Power Query M-expressie-editor.
  • Een referentieparameter of werkruimtevariabele moet beschikbaar zijn wanneer de dataflow draait.
  • Het wijzigen van een parameter, werkruimtevariabele, datum of tijdswaarde kan ervoor zorgen dat de naam van de opgeloste bestemming tussen de runs verandert.
  • Om bestemmingsinstellingen te parametriseren die niet door deze editor worden ondersteund, zie Geavanceerde bewerking voor data-bestemmingsqueries.