Vytváranie a správa knižníc premenných

Knižnice premenných Microsoft Fabric umožňujú vývojárom prispôsobiť a zdieľať konfigurácie položiek v rámci pracovného priestoru s cieľom zjednodušiť správu životného cyklu obsahu. Tento článok vysvetľuje, ako vytvárať, spravovať a používať knižnice premenných.

Podrobnejší návod na tento proces nájdete v kurze na používanie knižníc premenných.

Prerequisites

Ak chcete vytvoriť variabilné položky knižnice v Fabric, potrebujete:

• konto nájomníka služby Fabric s aktívnym predplatným, Vytvorte si bezplatné konto.

• Pracovný priestor s kapacitou služby Microsoft Fabric.

• Nasledujúce prepínače nájomníkov povolené z portálu na správu:

  • Používatelia môžu vytvárať položky služby Fabric

  Správca nájomníka, správca kapacity alebo správca pracovného priestoru môže povoliť tieto prepínače v závislosti od nastavení vašej organizácie.

Dôležité informácie o zabezpečení a správa povolení pre knižnice premenných Fabric

Knižnice premenných tkaniny sú výkonné konštrukcie, ktoré umožňujú centralizovanú správu premenných vo viacerých položkách štruktúry. Táto flexibilita však prináša kritické aspekty zabezpečenia.

Keďže samotné knižnice premenných sú položkami Fabric, riadia sa vlastnými množinami povolení . Tieto množiny povolení sa môžu líšiť od množín položiek, ktoré spotrebúvajú ich premenné. Tento nesúlad môže viesť k scenárom, keď má používateľ prístup na zápis do knižnice premenných, ale nemá žiadny prístup k spotrebúvajúcej položke.

V takýchto prípadoch môžu neoprávnení používatelia upravovať hodnoty premenných spôsobmi, ktoré úmyselne alebo neúmyselne menia správanie závislých položiek Fabric. Táto schopnosť vytvára potenciálny vektor útoku, kde by škodlivé aktualizácie zdieľaných premenných mohli ohroziť integritu, zabezpečenie alebo funkčnosť týchto položiek.

Ak chcete tieto riziká zmierniť, postupujte podľa týchto kľúčových postupov:

• Prijmite prísne ovládacie prvky povolení: Správcovia musia starostlivo spravovať povolenia na zápis do premenných knižníc, aby ich mohli upravovať iba dôveryhodní používatelia alebo služby. Táto prax zahŕňa vyhýbanie sa príliš tolerantívnemu prístupu a pravidelnú kontrolu priradenia povolení.
• Použiť odkazy na dôveryhodné knižnice: Položky by mali odkazovať iba na premenné z knižníc, ktoré sú explicitne označené ako dôveryhodné. Tento model dôvery by sa mal presadzovať prostredníctvom politík riadenia, ktoré overujú zdroj odkazov na premenné počas vývoja a nasadenia.

Ďalšie informácie nájdete v téme Povolenia knižnice premenných.

Vytvorenie položky knižnice premenných

Variabilnú položku knižnice môžete vytvoriť na domovskej stránke služby Fabric alebo v pracovnom priestore:

Domovská stránka

1. Na postrannom paneli vyberte Vytvoriť. (Ak tam nie je, vyberte tri bodky a potom vyberte Vytvoriť.)

2. V časti Data Factory vyberte položku Knižnica premenných.

   

3. Pomenujte novú knižnicu premenných a potom vyberte položku Vytvoriť. Uistite sa, že názov zodpovedá požadovaným konvenciám pomenovania.

Pracovný priestor

1. Vyberte položku + Nová položka.

2. Posuňte sa nadol do časti Vyvolať údaje a vyberte položku Knižnica premenných.

   

3. Pomenujte novú knižnicu premenných a potom vyberte položku Vytvoriť. Uistite sa, že názov zodpovedá požadovaným konvenciám pomenovania.

Zobrazí sa prázdna knižnica premenných. Teraz do nej môžete pridať premenné.

Správa knižníc premenných a ich premenných

Premenné v knižnici premenných môžete spravovať z horného panela s ponukami.

Pridanie premennej

Pridanie novej premennej do knižnice:

1. Vyberte + Nová premenná.
2. Zadajte názov. Uistite sa, že je v súlade s konvenciami pomenovania.
3. V rozbaľovacom zozname vyberte typ. Pozrite si zoznam podporovaných typov premenných.
4. Zadajte predvolenú hodnotu.
5. Pridajte poznámku, ktorá vysvetľuje, na čo premenná slúži alebo ako ju používať (voliteľné).
6. Vyberte položku Uložiť.

Odstránenie alebo úprava premennej

• Ak chcete odstrániť premennú, vyberte jednu alebo viac premenných a potom vyberte položku Odstrániť premennú>Uložiť.
• Ak chcete upraviť názov, typ alebo množinu hodnôt premennej, zmeňte hodnotu a potom vyberte položku Uložiť.
• Ak chcete pridať ďalšiu alternatívnu množinu hodnôt, vyberte položku Pridať hodnotu nastavenú.

Note

Výberom možnosti Uložiť po úprave ľubovoľnej premennej v knižnici premenných sa spustí kontrola overenia chyby, aby sa uistila, že všetky názvy a hodnoty premenných sú platné. Pred uložením zmien musíte opraviť všetky chyby.

Pridanie množiny hodnôt

Pridanie ďalšej množiny hodnôt, ktorú môžete použiť v inej fáze:

1. Vyberte položku Pridať množinu hodnôt.

2. Pomenujte množinu hodnôt. Uistite sa, že je v súlade s konvenciami pomenovania. Dajte mu popis (voliteľný) s maximálnou dĺžkou 2 048 znakov.

3. Ak chcete túto hodnotu použiť ako aktuálne aktívnu hodnotu nastavenú v tomto pracovnom priestore, vyberte položku Nastaviť ako aktívnu.

4. Zadajte hodnoty pre všetky premenné v knižnici premenných.

5. Vyberte položku Uložiť.

Úprava množiny hodnôt

Úprava množiny hodnôt:

1. Vyberte tri bodky vedľa názvu množiny hodnôt.

2. Vyberte položku Nastaviť ako aktívnu (pre tento pracovný priestor), Premenovať alebo Odstrániť.

   

3. Vyberte položku Uložiť. Zmeny sa prejavia až po ich uložení.

Ak chcete obnoviť hodnotu každej premennej na predvolenú hodnotu, vyberte tlačidlo reset.

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.