Sdílet prostřednictvím

Integrace knihovny proměnných s kanály

Knihovna proměnných je nový typ položky v Microsoft Fabric, který uživatelům umožňuje definovat a spravovat proměnné na úrovni pracovního prostoru, takže se brzy mohou používat napříč různými položkami pracovního prostoru, jako jsou pipeline, notebooky, zkratky pro lakehouse a další. Poskytuje jednotný a centralizovaný způsob správy konfigurací, což snižuje potřebu pevně zakódovaných hodnot a zjednodušuje procesy CI/CD, což usnadňuje správu konfigurací v různých prostředích.

Jak používat knihovnu proměnných s potrubími

  1. Přejděte do svého pracovního prostoru a vytvořte novou položku.

    Snímek obrazovky, na kterém je zvýrazněno místo pro přidání nové položky do pracovního prostoru Fabric.

  2. Pomocí filtru vyhledejte knihovnu proměnných nebo se posuňte dolů do části Vývoj dat.

    Snímek obrazovky zobrazující filtr pro novou položku knihovny proměnných

  3. Vyberte knihovnu proměnných a vytvořte novou knihovnu proměnných. Zvolte název a stiskněte Vytvořit.

    Snímek obrazovky znázorňující novou položku knihovny proměnných se sadou názvů a zvýrazněným tlačítkem Vytvořit

  4. Po vytvoření knihovny proměnných přejdete na domovskou stránku. Kliknutím na + Nový přidejte novou proměnnou.

    Snímek obrazovky znázorňující úvodní stránku nové položky knihovny proměnných

  5. Po přidání nové proměnné můžete nakonfigurovat proměnnou a nastavit sadu hodnot Name, Type a Default. Můžete také přidat poznámky.

    Snímek obrazovky znázorňující konfigurace, které se mají nastavit pro novou proměnnou

  6. Přidejte podle potřeby alternativní sady hodnot (například různé hodnoty pro různá prostředí kanálu nasazení). Po nastavení názvu a kliknutí na Vytvořit můžete upravit hodnoty proměnných a zvolit hodnotu nastavenou tak, aby byla aktivní.

    Snímek obrazovky se zvýrazněním místa pro přidání nových sad hodnot pro proměnnou

    Snímek obrazovky znázorňující, jak přidat název nové sady hodnot

  7. Po dokončení změny uložte.

Snímek obrazovky se zvýrazněným tlačítkem Uložit v levém horním rohu

Použijte proměnné knihovny proměnných ve vašem kanálu

  1. Pokud chcete v potrubí použít proměnnou z knihovny proměnných, vytvořte nové potrubí nebo přejděte k existujícímu potrubí.

  2. V rámci vašeho pipeline je potřeba vytvořit referenci k proměnné v knihovně proměnných v dolním panelu.

    Snímek obrazovky se zvýrazněnou kartou Proměnné knihovny a tlačítkem +Nový v dolním panelu plátna pipeline

  3. Po kliknutí na + Nový se otevře automaticky otevírané okno, které zobrazí všechny knihovny proměnných. K výběru proměnné z knihovny proměnných můžete použít tento nástroj a kliknout na Ok.

    Snímek obrazovky se zvýrazněným tlačítkem +Nový na záložce knihovny proměnných

    Snímek obrazovky znázorňující proměnnou knihovny vybranou v nástroji pro výběr proměnné

    Snímek obrazovky zobrazující konfigurační sadu pro nový odkaz na proměnnou v knihovně

  4. Po přidání odkazů na proměnné knihovny přidejte aktivity potrubí. V nastavení aktivity klikněte na Přidat dynamický obsah pro nastavení, které chcete parametrizovat.

    Snímek obrazovky s nastavením aktivity Vyhledávání, kde je zvýrazněno Přidat dynamický obsah.

  5. Otevře se tvůrce výrazů. Pokud nevidíte proměnné knihovny, klikněte na tři tečky vedle funkce a vyberte Proměnné knihovny.

    Snímek obrazovky znázorňující tři tečky vedle funkcí v tvůrci výrazů a zvýrazněnou kartu Proměnné knihovny

  6. Kliknutím na odkaz na proměnnou knihovny přidáte do tvůrce výrazů nový výraz. Potom kliknutím na ok přidejte výraz.

    Snímek obrazovky zvýrazňuje odkaz na proměnnou knihovny, který se má přidat do nástroje pro tvorbu výrazů.

    Snímek obrazovky znázorňující sadu výrazů v tvůrci výrazů

  7. Teď uvidíte, že se dynamický obsah přidá do nastavení aktivity.

    Snímek obrazovky zobrazující výraz nastavený jako dynamický obsah v nastavení aktivity Vyhledávání

  8. Náhled dat můžete zobrazit kliknutím na Náhled dat. Otevře se nové podokno, ve které se zobrazí hodnota proměnné knihovny. Kliknutím na ok zobrazíte náhled dat.

    Snímek obrazovky znázorňující možnost náhledu dat

    Snímek obrazovky s podoknem náhledu dat

  9. Uložte a spusťte své potrubí, jak byste to normálně udělali. Uvidíte, že předaná hodnota je jakákoli hodnota nastavená jako Aktivní v knihovně proměnných.

    Snímek obrazovky se zvýrazněným nastavením Uložit a spustit na ploše potrubí.

Známá omezení

Známá omezení, která následují, platí pro integraci knihovny proměnných v datových tocích ve službě Data Factory v Microsoft Fabric.

  • Knihovna proměnných podporuje datové typy Boolean, Datetime, Guid, Integer, Number a String. V kanálu uvidíte logickou hodnotu jako typ Bool, Datetime jako typ String, Guid jako typ String, Integer jako typ Int a String jako typ String. V kanálech nejsou podporovány číselné typy.
  • Parametrizace externího připojení je podporována knihovnou proměnných integrovanou s potrubími. Musíte ale vyhledat identifikátor GUID pro vaše připojení z Nastavení | Správa připojení a bran Identifikátor GUID pro vaše připojení najdete tak, že vyberete Nastavení vedle názvu připojení.

Související obsah

  • Last updated on