Čo je to knižnica premenných?

Knižnica premenných Microsoft Fabric je sektor premenných, ktoré môžu iné položky v pracovnom priestore spotrebovať ako súčasť správy životného cyklu aplikácií (ALM). Funguje ako položka v rámci pracovného priestoru, ktorá obsahuje zoznam premenných, spolu s ich príslušnými hodnotami pre každú fázu kanála vydania. Predstavuje jednotný prístup k efektívnej správe konfigurácií položiek v rámci pracovného priestoru, ktorý pomáha zabezpečiť škálovateľnosť a konzistentnosť vo fázach životného cyklu.

Knižnica premenných môže napríklad obsahovať premenné, ktoré obsahujú hodnoty:

• Celé číslo, ktoré sa má použiť v rámci aktivity čakania v kanáli.
• Odkaz na Lakehouse, ktorý má byť zdrojom v aktivite kopírovania údajov . Každá hodnota sa používa v inom potrubí na základe fázy uvoľnenia potrubia.
• Odkaz na dom pri jazere, ktorý sa má nakonfigurovať ako predvolený notebook pri jazere. Každá hodnota sa používa v inom kanáli na základe fázy vydania poznámkového bloku.

Riešenie hodnôt v spotrebiteľskej položke nemusí byť nevyhnutne spojené s jej nasadením. Namiesto toho každá spotrebiteľská položka vyrieši hodnotu na základe vlastného kontextu.

Prostredie knižnice premenných sa líši v závislosti od typu premennej, ale všetky knižnice premenných umožňujú definovať a spravovať premenné, ktoré môžu používať iné položky.

Knižnica premenných Fabric:

• Je kompatibilný s procesmi kontinuálnej integrácie a nepretržitého doručovania (CI/CD). Táto kompatibilita umožňuje integráciu s Gitom a nasadenie prostredníctvom kanálov nasadenia.
• Podporuje automatizáciu prostredníctvom verejných rozhraní API služby Fabric.

Výhody

Variabilné knižnice umožňujú zákazníkom prispôsobiť a zdieľať konfigurácie.

Prispôsobenie konfigurácií

Hodnotu premennej môžete nakonfigurovať na základe fázy kanála vydania. Knižnicu premenných môžete nakonfigurovať s množinami hodnôt: jedna hodnota pre každú fázu kanála vydania. Potom sa po jednorazovom nastavení aktívnej hodnoty nastavenej pre každú fázu automaticky použije správna hodnota vo fáze kanála. Príklady:

• Zmena pripojenia položky na základe fázy.
• Prechod na iný cloudový zdroj údajov na základe fázy.
• Úprava množstva údajov v dotaze na základe fázy.

Konfigurácie zdieľania

Knižnice premenných poskytujú centralizovaný spôsob spravovania konfigurácií v rámci položiek pracovného priestoru. Ak máte napríklad v pracovnom priestore niekoľko jazerných domov a každý z nich má odkaz, ktorý používa rovnaký zdroj údajov, môžete vytvoriť knižnicu premenných s týmto zdrojom údajov ako jednou z premenných. Týmto spôsobom, ak chcete zmeniť zdroj údajov, musíte ho zmeniť iba raz v knižnici premenných. Nemusíte ho meniť v každom jazere zvlášť.

Štruktúra knižnice premenných

Knižnice premenných obsahujú jednu alebo viac premenných. Každá premenná má názov, typ a predvolenú hodnotu. K každej premennej môžete pridať aj poznámku, ktorá popisuje jej účel alebo spôsob jej používania.

Predvolená hodnota

Predvolená hodnota je hodnota, ktorá sa použije, pokiaľ konkrétne nedefinujete inú hodnotu.

Všetky premenné musia mať predvolenú hodnotu. Ak je typ premennej reťazec, predvolená hodnota môže byť null.

Alternatívne množiny hodnôt

Množiny hodnôt definujú hodnoty každej premennej v knižnici premenných. Knižnica premenných zvyčajne obsahuje viacero množín hodnôt. Aktívna (alebo efektívna) množina hodnôt obsahuje hodnotu, ktorú spotrebiteľská položka dostane pre daný pracovný priestor.

V každom pracovnom priestore vyberte hodnotu, ktorá má byť aktívna. Aktívna množina hodnôt pracovného priestoru sa počas nasadenia alebo aktualizácie z Gitu nemení.

Keď vytvoríte alternatívnu množinu hodnôt, vytvorí sa nová množina hodnôt s ukazovateľmi na predvolenú hodnotu každej premennej. Potom môžete zmeniť hodnotu každej premennej v novej množine hodnôt.

Podporované položky

Knižnicu premenných podporujú nasledujúce položky:

• Potrubie
• Skratka pre jazerný dom
• Notebook , prostredníctvom NotebookUtils a %%configure
• Tok údajov 2. generácie
• Kopírovať úlohu

Dôležité informácie a obmedzenia

Obmedzenia veľkosti

• Môže existovať až 1 000 premenných a až 1 000 množín hodnôt, pokiaľ spĺňate obe tieto požiadavky:

  • Celkový počet buniek v alternatívnych množinách hodnôt je menší ako 10 000.
  • Veľkosť položky nepresahuje 1 MB.

  Tieto požiadavky sa overia pri ukladaní zmien.

• Pole poznámky môže mať maximálne 2 048 znakov.

• Pole popisu množiny hodnôt môže mať až 2 048 znakov.

Obmedzenia pre alternatívne množiny hodnôt

• Alternatívne množiny hodnôt v knižnici premenných sa zobrazujú v poradí, v akom ste ich pridali. V súčasnosti ich nie je možné zmeniť v používateľskom rozhraní. Ak chcete zmeniť poradie, upravte súbor JSON priamo.
• Názov každej množiny hodnôt musí byť v knižnici premenných jedinečný.
• Názvy premenných musia byť v knižnici premenných jedinečné. V pracovnom priestore môžete mať dve premenné s rovnakým názvom, ak sa nachádzajú v rôznych položkách.
• V knižnici premenných je vždy nastavená jedna (a len jedna) aktívna hodnota. Množinu hodnôt nemôžete odstrániť, keď je aktívna. Ak ho chcete odstrániť, najskôr nakonfigurujte inú množinu hodnôt tak, aby bola aktívna. Pre každú fázu kanála nasadenia môžete nastaviť inú aktívnu hodnotu.

Súvisiaci obsah

• povolení pre knižnicu premenných
• Vytváranie a správa knižníc premenných