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 procesu na základě fáze uvolnění procesu.
  • Odkaz na lakehouse, který má být nakonfigurován jako výchozí lakehouse pro poznámkový blok. Každá hodnota se používá v jiném datovodu, v závislosti na fázi vydání notebooku.

Knihovna proměnných pro Fabric:

  • 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.
  • 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.

Výhody

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

Přizpůsobení konfigurací

Můžete nakonfigurovat hodnotu proměnné na základě fáze vydávacího kanálu. Knihovnu proměnných můžete nakonfigurovat sady hodnot: jedna hodnota pro každou fázi vydávacího potrubí. Poté se po jednorázovém nastavení aktivní hodnoty pro každou etapu potrubí automaticky použije správná hodnota v této etapě. Mezi příklady patří:

  • Změna připojení položky podle 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 to měnit v každém lakehouse zvlášť.

Struktura knihovny proměnných

Knihovna proměnných ve Fabricu je strukturovaný systém určený ke správě konfiguračních parametrů napříč pracovními prostory a fázemi nasazení. Jádrem jsou uživatelem definované proměnné, které můžou být základní typy (například řetězec, celé číslo, logická hodnota) nebo komplexní typy, jako jsou odkazy na položky. Tyto proměnné jsou seskupené v položce knihovny proměnných a lze na tyto proměnné odkazovat podle položek příjemce ve stejném pracovním prostoru.

Pro podporu dynamické konfigurace může mít každá proměnná více sad hodnot nebo alternativních sad hodnot přizpůsobených pro různá prostředí (např. vývoj, testování, prod). Jedna sada hodnot je určena jako aktivní pro každý pracovní prostor a určuje, které hodnoty se používají během běhu.

Uživatelé můžou vytvářet, upravovat a spravovat proměnné a sady hodnot prostřednictvím uživatelského rozhraní nebo rozhraní API infrastruktury s integrovaným ověřováním a kontrolami oprávnění. Systém podporuje pracovní postupy CI/CD, což umožňuje správu proměnných jako kódu, integraci s Git a nasazení prostřednictvím pipeline. Tato struktura zajišťuje škálovatelnou, automatizovanou a řízenou správu konfigurací napříč komplexními datovými systémy.

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

Podporované položky

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

Názvoslovné konvence

Název položky knihovny proměnných musí dodržovat tyto konvence:

  • Není prázdný.
  • Nemá úvodní ani koncové mezery.
  • Začíná písmenem
  • Může obsahovat písmena, číslice, podtržítka, pomlčky a mezery.
  • Délka nepřekračuje 256 znaků

Název knihovny proměnných nerozlišuje malá a velká písmena.

Úvahy a omezení

Omezení proměnných

  • 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 knihovně proměnných je vždy současně pouze jedna aktivní hodnota. 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.

Související obsah

  • Last updated on