Sdílet prostřednictvím

Použití knihoven proměnných Fabric v Dataflow Gen2 (Preview)

Poznámka:

Tato funkce je aktuálně ve verzi preview a je dostupná pouze pro Dataflow Gen2 s CI/CD. Další informace o tom, jak tuto funkci využít ve scénářích kontinuální integrace a průběžného nasazení (CI/CD), najdete v článku o architekturách řešení CI/CD a ALM pro Tok dat Gen2 a kompletní kurz o odkazech na proměnné v toku dat.

Knihovny proměnných pro Microsoft Fabric nabízejí centralizovaný způsob správy hodnot konfigurace napříč úlohami Microsoft Fabric. Díky nové integraci toku dat Gen2 (Preview) můžete na tyto proměnné odkazovat přímo ve svém toku dat, což umožňuje dynamické chování napříč prostředími a zjednodušuje pracovní postupy CI/CD.

Požadavky

Pokud chcete v Toku dat Gen2 používat knihovny proměnných Fabric, ujistěte se, že platí následující:

Jak používat knihovny proměnných služby Fabric v Dataflow Gen2

Uvnitř toku dat Gen2 můžete na proměnnou odkazovat pomocí některé z následujících funkcí:

Očekávaný identifikátor, který musí být předán některé z těchto dvou funkcí, musí dodržovat formát:

$(/**/LibraryName/VariableName)

Následující příklady pro obě funkce ve scénáři, ve kterém máte knihovnu proměnných s názvem Moje knihovna a proměnnou typu řetězec s názvem Moje proměnná:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

Při použití této funkce na skript dotazu použijeme následující ukázkový dotaz, který se připojí k tabulce s názvem Table1 z konkrétního LakehouseId a WorkspaceId pomocí konektoru Fabric Lakehouse.

let
  Source = Lakehouse.Contents([]),
  #"Navigation 1" = Source{[workspaceId = "cfafbeb1-8037-4d0c-896e-a46fb27ff229"]}[Data],
  #"Navigation 2" = #"Navigation 1"{[lakehouseId = "5b218778-e7a5-4d73-8187-f10824047715"]}[Data],
  #"Navigation 3" = #"Navigation 2"{[Id = "Table1", ItemKind = "Table"]}[Data]
in
  #"Navigation 3"

Plánujete nahradit hodnoty předané pro workspaceId a lakehouseId tak, aby ve scénářích CI/CD dynamicky odkazovaly na správnou položku ve správné fázi.

Za tímto účelem ve stejném pracovním prostoru, ve kterém se nachází tok dat, máte také knihovnu proměnných s názvem Moje knihovna , která obsahuje následující proměnné, na které chcete v toku dat odkazovat:

Název proměnné Typ proměnné Výchozí sada hodnot
ID pracovního prostoru String a8a1bffa-7eea-49dc-a1d2-6281c1d031f1
Lakehouse ID String 37dc8a41-dea9-465d-b528-3e95043b2356

Pomocí těchto informací můžete upravit skript dotazu tak, aby nahradil hodnoty, které vedou k dalšímu skriptu:

let
  Source = Lakehouse.Contents([]),
  #"Navigation 1" = Source{[workspaceId = Variable.ValueOrDefault("$(/**/My Library/Workspace ID)",  "cfafbeb1-8037-4d0c-896e-a46fb27ff229")]}[Data],
  #"Navigation 2" = #"Navigation 1"{[lakehouseId =  Variable.ValueOrDefault("$(/**/My Library/Lakehouse ID)","5b218778-e7a5-4d73-8187-f10824047715")]}[Data],
  #"Navigation 3" = #"Navigation 2"{[Id = "Table1", ItemKind = "Table"]}[Data]
in
  #"Navigation 3"

Když spustíte tok dat s upraveným skriptem, přeloží se na hodnotu z proměnné a správný datový typ definovaný proměnnou. Toto odkazuje na jiný pracovní prostor a Lakehouse v závislosti na hodnotách, které jsou k dispozici v době spuštění toku dat.

Upozornění

Editor Power Query v současné době nepodporuje vyhodnocení proměnných. Doporučujeme použít funkci Variable.ValueOrDefault , abyste měli jistotu, že prostředí pro vytváření obsahu používá výchozí hodnotu pro vytváření prototypů.

Použití výchozí hodnoty prostřednictvím variable.ValueOrDefault zajišťuje, že vzorec bude vyřešen, i když zkopírujete nebo přesunete řešení do jiného prostředí, které nemá knihovnu referenčních proměnných. Za běhu se proměnná přeloží na správnou hodnotu.

Úvahy a omezení

Následující seznam popisuje důležitá omezení a chování, které je potřeba mít na paměti při používání knihoven proměnných Fabric s tokem Dataflow Gen2. Tato omezení ovlivňují, jak jsou proměnné odkazovány, vyhodnocovány a používány během návrhu a doby běhu.

  • Obor pracovního prostoru: Knihovny proměnných musí být umístěny ve stejném pracovním prostoru jako Dataflow Gen2 s CI/CD.

  • Referenční umístění: Proměnné lze použít pouze uvnitř souboru mashup.pq u toku dat Gen2 s CI/CD.

  • Chování modulu runtime: Hodnoty proměnných se načítají na začátku operace spuštění a uchovávají se v celé operaci. Změny, ke kterým dochází v knihovně během běhu toku dat, tento běh nezastaví ani neovlivní.

  • Podpora editoru Power Query: V editoru Power Query není k dispozici žádná aktuální podpora pro překlad nebo vyhodnocení proměnných.

  • Použití výchozí hodnoty: Při použití výchozí hodnoty prostřednictvím funkce Variable.ValueOrDefault se ujistěte, že datový typ výchozí hodnoty odpovídá datovému typu odkazované proměnné.

  • Podporované typy: Podporují se pouze proměnné základních typů (boolean, datetime, guid, integer, numbera string).

  • Pevná připojení: Proměnné nemůžou měnit informace o připojení. Připojení zůstávají pevná pro konfigurace cesty k zadanému prostředku.

  • Nadřazené riziko: Uživatelé s přístupem k úpravám knihoven proměnných mohou přepsat hodnoty proměnných, což může mít vliv na výstup datového toku.

  • Mapování schématu: Proměnné nemůžou změnit mapování cílového schématu; mapování se řídí vytvořeným nastavením.

  • Viditelnost rodokmenu: Zobrazení rodokmenu nezobrazují propojení mezi tokem dat Gen2 a knihovnami proměnných, na které odkazuje.

  • Omezení proměnných: Toky dat můžou načíst maximálně 50 proměnných.

  • Podpora SPN: Toky dat lze úspěšně obnovit pouze v případě, že není použito SPN pro autentizaci.

  • Last updated on