Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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í.
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í.
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:
- Potrubí
- Zástupce pro Lakehouse
- Notebook prostřednictvím NotebookUtils a
%%configure - Dataflow Gen2
- Úloha kopírování
- Funkce uživatelských dat
Ú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.