Użyj edytora wyrażeń dynamicznych dla miejsc docelowych danych Dataflow Gen2 (wersja zapoznawcza)

Uwaga / Notatka

Edytor wyrażeń dynamicznych dla miejsc docelowych danych jest obecnie dostępny w wersji zapoznawczej.

Edytor wyrażeń dynamicznych umożliwia tworzenie wartości w obsługiwanych docelowych polach danych przez łączenie tekstu z wartościami, których wartości są ustalane podczas działania przepływu danych. Na przykład możesz dodać datę odświeżenia UTC w nazwie pliku, użyć parametru nazwy tabeli lub uwzględnić wartość specyficzną dla przestrzeni roboczej.

Edytor jest domyślnie włączony. Gdy używasz go po raz pierwszy, instrukcja nauczania wyjaśnia, jak otworzyć menu wartości dynamicznych.

Dostępne wartości

Wartości dostępne w edytorze zależą od przepływu danych i konfiguracji przestrzeni roboczej.

Category Opis
Wartości dynamiczne Wartości daty i czasu UTC dla uruchomienia przepływu danych. Data używa yyyyMMdd, Czas używa HHmmss, a Data/Czas używa yyyyMMddHHmmss. Na przykład wartość Date/Time może się rozłożyć na 20201230232459 30 grudnia 2020 o 23:24:59 UTC.
Parametry Parametry, które definiujesz w przepływie danych. Wybierz Zarządzanie parametrami w menu, aby utworzyć lub edytować parametry.
Zmienne w przestrzeni roboczej Wbudowane wartości przestrzeni roboczej, takie jak currentWorkspaceId, oraz wartości z elementów Fabric Variable Library dostępnych dla przepływu danych.

Stwórz dynamiczną tabelę lub nazwę pliku

  1. W edytorze Power Query dodaj cel danych do zapytania.

  2. Umieść kursor w polu docelowym, które obsługuje wyrażenia dynamiczne, takie jak Nazwa Tabeli lub Nazwa Pliku.

  3. Wprowadź dowolny tekst, który powinien pozostać taki sam za każdym razem, gdy przepływ danych jest uruchamiany.

  4. Naciśnij go / , aby otworzyć menu dynamicznych wartości.

    Zrzut ekranu przedstawiający otwarte menu wartości dynamicznych w polu Nazwa pliku. Menu zawiera opcje Data, Godzina, Data/godzina, parametry oraz zmienne obszaru roboczego.

  5. Wybierz wartość dynamiczną, parametr lub zmienną w przestrzeni roboczej. Możesz też zacząć pisać po /, aby filtrować menu.

  6. Kontynuuj wprowadzanie tekstu i wartości, aż wyrażenie będzie kompletne. Aby wybrać cel pliku, należy dodać rozszerzenie jako tekst.

    Zrzut ekranu dynamicznej nazwy pliku łączącej tekst z tokenami Date, Time oraz Date/Time.

  7. Dokończ konfigurację docelowego miejsca danych, a następnie opublikuj przepływ danych.

W czasie działania Dataflow Gen2 rozwiązuje każdy token i łączy wartości z tekstem w wyrażeniu. Normalne zachowanie docelowe nadal ma zastosowanie do powstałej nazwy. Na przykład docelowy plik może nadpisać istniejący plik, gdy ustalona nazwa pliku jest taka sama jak nazwa istniejącego pliku.

Edytuj wyrażenie

Możesz edytować tekst i wstawiać więcej wartości w dowolnym miejscu wyrażenia.

  • Aby otworzyć menu bez użycia myszy, naciśnij /. Użyj klawiszy strzałek, aby poruszać się po menu, a następnie naciśnij Enter , aby wstawić wybraną wartość.
  • Aby zamknąć menu bez wybrania wartości, naciśnij Esc. Znacznik / oraz cały tekst wpisany po nim pozostaną w polu jako tekst.
  • Aby usunąć wstawioną wartość, umieść kursor obok jego tokena i naciśnij Backspace lub Delete.

Przykładowe wyrażenia

Scenario Expression
Dodaj datę i godzinę uruchomienia do nazwy pliku Orders-<Date>-<Time>.csv
Użyj parametru przepływu danych jako prefiksu nazwy tabeli <Environment>_Sales
Umieść aktualną przestrzeń roboczą w nazwie Sales_<currentWorkspaceId>

W edytorze wartości pokazane w nawiasach kątnych w tych przykładach pojawiają się jako tokeny. Nie wpisuje się nawiasów ostrokątnych.

Ważna

Rozwiązana tabela lub nazwa pliku musi spełniać zasady nazewnictwa wybranego miejsca docelowego. Jeśli wartość dynamiczna wprowadza znaki nieobsługiwane lub tworzy nieprawidłową nazwę, walidacja docelowa lub uruchomienie przepływu danych może zawiódć.

Wyłącz lub włącz edytor wyrażeń dynamicznych

Edytor wyrażeń dynamicznych jest domyślnie włączony. Twoje preferencje są przechowywane w cookie przeglądarki i nie są zapisywane w usłudze Fabric. W efekcie to ustawienie nie jest przenoszone na przeglądarki ani urządzenia i może wrócić do domyślnego stanu, jeśli usuniesz pliki cookie przeglądarki. Aby go zmienić:

  1. W edytorze Power Query wybierz Opcje z zakładki Home.
  2. W oknie Opcje wybierz Globalne>Ogólne.
  3. Przewiń do sekcji Dane docelowe .
  4. W Edytorze wyznacz opcję Włącz edytor wyrażeń dynamicznych , aby wyłączyć edytor. Zaznacz pole zaznaczenia, aby ponownie go włączyć.
  5. Kliknij przycisk OK.

Zrzut ekranu okna dialogowego Opcje z zaznaczonym ustawieniem „Włącz edytor wyrażeń dynamicznych” w sekcji Miejsca docelowe danych.

Wyłączenie edytora nie usuwa wyrażeń dynamicznych, które są już skonfigurowane.

Uwagi i ograniczenia

  • Dostępność zależy od wybranego miejsca docelowego i pola danych.
  • Edytor łączy tekst i dostępne wartości. To nie jest uniwersalny edytor wyrazów Power Query M.
  • Parametr, do którego się odwołano, lub zmienna obszaru roboczego muszą być dostępne podczas wykonywania przepływu danych.
  • Zmiana parametru, zmiennej obszaru roboczego, wartości daty lub czasu może spowodować zmianę wynikowej nazwy miejsca docelowego przy kolejnych uruchomieniach.
  • Aby parametryzować ustawienia docelowe, które nie są obsługiwane przez ten edytor, zobacz Advanced edit dla zapytań o docelowe dane.