Sdílet prostřednictvím


Co je knihovna proměnných?

Knihovna proměnných Microsoft Fabric je kontejner proměnných, které ostatní položky v pracovním prostoru můžou využívat jako součást správy životního cyklu aplikací (ALM). Funguje jako položka v pracovním prostoru, která obsahuje seznam proměnných spolu s jejich odpovídajícími hodnotami pro každou fázi nasazovacího procesu. Představuje jednotný přístup pro efektivní správu konfigurací položek v rámci pracovního prostoru, který pomáhá zajistit škálovatelnost a konzistenci napříč fázemi životního cyklu.

Knihovna proměnných může například obsahovat proměnné, které obsahují hodnoty pro:

  • Celé číslo, které se má použít v aktivitě čekání v kanálu.
  • Odkaz na lakehouse jako zdroj v aktivitě kopírování dat . Každá hodnota se používá v jiném kanálu na základě fáze vydání kanálu.
  • Odkaz na lakehouse, který se má nakonfigurovat jako výchozí lakehouse poznámkového bloku. Každá hodnota se používá v jiném kanálu v závislosti na fázi vydání poznámkového bloku.

Rozlišení hodnoty u položky pro spotřebitele nemusí být nutně svázané s jejím nasazením. Každá spotřební položka určuje hodnotu na základě svého vlastního kontextu.

Prostředí knihovny proměnných se liší podle typu proměnné, ale všechny knihovny proměnných umožňují definovat a spravovat proměnné, které můžou používat jiné položky.

Knihovna proměnných prostředků infrastruktury:

  • Je kompatibilní s procesy kontinuální integrace a průběžného doručování (CI/CD). Tato kompatibilita umožňuje integraci s Gitem a nasazením prostřednictvím kanálů nasazení.
  • Podporuje automatizaci prostřednictvím veřejných rozhraní API fabric.

Výhody

Knihovny proměnných umožňují zákazníkům přizpůsobit a sdílet konfigurace.

Přizpůsobení konfigurací

Můžete nakonfigurovat hodnotu proměnné na základě fáze kanálu verze. Knihovnu proměnných můžete nakonfigurovat se sadami hodnot: jedna hodnota pro každou fázi kanálu verze. Potom se po jednorázovém nastavení aktivní hodnoty nastavené pro každou fázi automaticky použije správná hodnota ve fázi kanálu. Mezi příklady patří:

  • Změna připojení položky na základě fáze
  • Přechod na jiný cloudový zdroj dat na základě fáze
  • Úprava množství dat v dotazu na základě fáze

Sdílení konfigurací

Knihovny proměnných poskytují centralizovaný způsob správy konfigurací napříč položkami pracovního prostoru. Pokud máte například v pracovním prostoru několik jezer a každý z nich má zástupce, který používá stejný zdroj dat, můžete vytvořit knihovnu proměnných s tímto zdrojem dat jako jednu z proměnných. Pokud tedy chcete změnit zdroj dat, musíte ho změnit jenom jednou v knihovně proměnných. Nemusíte ho měnit v každém jezeře samostatně.

Struktura knihovny proměnných

Knihovny proměnných obsahují jednu nebo více proměnných. Každá proměnná má název, typ a výchozí hodnotu. Ke každé proměnné můžete také přidat poznámku, která popisuje její účel nebo způsob jeho použití.

Snímek obrazovky knihovny proměnných s několika proměnnými a jejich základními komponentami

Výchozí hodnota

Výchozí hodnota je hodnota, která se používá, pokud nedefinujete jinou hodnotu.

Všechny proměnné musí mít výchozí hodnotu. Pokud je typ proměnné řetězec, může být nullvýchozí hodnota .

Alternativní sady hodnot

Sady hodnot definují hodnoty jednotlivých proměnných v knihovně proměnných. Knihovna proměnných obvykle obsahuje více sad hodnot. Sada aktivních (nebo efektivních) hodnot obsahuje hodnotu, kterou položka příjemce obdrží pro daný pracovní prostor.

V každém pracovním prostoru vyberete hodnotu nastavenou tak, aby byla aktivní. Aktivní sada hodnot pracovního prostoru se během nasazení nebo aktualizace z Gitu nezmění.

Snímek obrazovky knihovny proměnných s několika alternativními sadami hodnot

Když vytvoříte alternativní sadu hodnot, vytvoří se nová sada hodnot s ukazateli na výchozí hodnotu pro každou proměnnou. Pak můžete změnit hodnotu pro každou proměnnou v nové sadě hodnot.

Podporované položky

Následující položky podporují knihovnu proměnných:

Úvahy a omezení

Omezení velikosti

  • Může existovat až 1 000 proměnných a až 1 000 sad hodnot, pokud splňujete oba tyto požadavky:

    • Celkový počet buněk v alternativních sadách hodnot je menší než 10 000.
    • Velikost položky nepřesahuje 1 MB.

    Tyto požadavky se ověřují při ukládání změn.

  • Pole poznámky může mít až 2 048 znaků.

  • Pole popisu sady hodnot může mít až 2 048 znaků.

Omezení pro alternativní sady hodnot

  • Alternativní sady hodnot v knihovně proměnných se zobrazí v pořadí, ve kterém jste je přidali. V současné době je nemůžete v uživatelském rozhraní přeuspořádat. Pokud chcete změnit pořadí, upravte soubor JSON přímo.
  • Název každé sady hodnot musí být v knihovně proměnných jedinečný.
  • Názvy proměnných musí být v knihovně proměnných jedinečné. Pokud se nachází v různých položkách, můžete mít v pracovním prostoru dvě proměnné se stejným názvem.
  • Vždy existuje jedna (a pouze jedna) aktivní hodnota nastavená v knihovně proměnných najednou. Hodnotu nastavenou v době, kdy je aktivní, nemůžete odstranit. Pokud ho chcete odstranit, nejprve nakonfigurujte jinou sadu hodnot tak, aby byla aktivní. Pro každou fázi kanálu nasazení můžete mít jinou sadu aktivních hodnot.