Typy premenných v knižniciach premenných

Knižnica premenných v Fabric je špecializovaná položka, ktorá centralizuje definíciu a správu premenných, umožňujúc škálovateľnú a automatizovanú konfiguráciu naprieč pracovnými priestormi a položkami.

Premenné v knižnici premenných môžu byť základné alebo pokročilé typy a každá premenná je jednoznačne identifikovaná svojím názvom v rámci knižničnej položky.

• Základné typy premenných v knižnici premenných zahŕňajú jednoduché dátové typy ako Boolean, DateTime (vo formáte ISO 8601 UTC), Guid, Integer, Number a String. Ide o jednoduché hodnoty, ktoré je možné priamo priradiť a použiť naprieč rôznymi úrovňami a prostrediami.
• Pokročilé typy premenných sú navrhnuté pre sofistikovanejšie prípady použitia, ako je referencovanie interných Fabric položiek alebo externých spojení. Patria sem typy "item reference", ktoré ukladajú pracovné priestory a ID položiek na konkrétne Fabric položky.

Podporované typy v knižniciach premenných

Premenné v knižnici premenných majú nasledujúce podporované typy premenných

TypType	Kategória	Popis
booleovský	Basic	Predstavuje hodnoty pravda/lož.
Celé číslo	Basic	Celé čísla bez desatinných miest.
Číslo	Basic	Číselné hodnoty, vrátane desatinných čísel.
Povrázok	Basic	Textové hodnoty alebo sekvencie znakov.
Dátum a čas	Basic	Dátum a čas reprezentované normou ISO 8601 yyy-MM-ddTHH:mm:ss.xxxZ, kde: yyyy-MM-dd je štvorciferný rok, nasledovaný dvojciferným mesiacom a dvojciferným dňom. T oddeľuje dátum a čas. HH:mm:ss.xxx je dvojciferná hodina v 24-hodinovom formáte, nasledovaná dvojcifernou minútou, dvojcifernou sekundou a trojcifernou milisekundou. Z označuje, že čas je v koordinovanom svetovom čase (UTC).
GUID	Basic	Globálne jedinečný identifikátor používaný na identifikáciu rôznych objektov.
Referencia položky	Pokročilí	Používa sa v knižnici premenných Fabric na uchovávanie referencie na existujúci predmet Fabric – napríklad lakehouse, notebook alebo dátový pipeline – uložením ID pracovného priestoru a ID položky.
Referencia spojenia	Pokročilí	Premenná pracovného priestoru, ktorá uchováva ID externého dátového spojenia (napríklad Snowflake, Azure SQL), čo umožňuje položkám odkazovať na externé zdroje bez vkladania prihlasovacích údajov alebo spojovacích reťazcov.

Vlastnosti premenných

Každá premenná v knižnici premenných má nasledujúce vlastnosti:

Majetok	Popis
Name	Jedinečný identifikátor premennej. Používa sa na odkazovanie na premennú v skriptoch alebo pracovných postupoch.
Poznámka (voliteľné)	Popisný komentár alebo poznámka o premennej. Môže obsahovať kontext, poznámky k používaniu alebo špeciálne pokyny. Maximálna dĺžka: 2 048 znakov.
Typ	Definuje dátový typ premennej (napr. reťazec, celé číslo, boolean, pole). Určuje, ako je hodnota interpretovaná a overovaná.
Predvolená množina hodnôt	Počiatočná hodnota priradená premennej, keď nie je uvedená žiadna iná hodnota. Zabezpečuje konzistentné správanie v pracovných postupoch. Predvolená množina hodnôt sa nedá premenovať.
Alternatívne množiny hodnôt (voliteľné)	Ďalšie preddefinované množiny hodnôt, ktoré je možné aplikovať za špecifických podmienok alebo scenárov. Užitočné pre konfigurácie špecifické pre prostredie alebo záložné možnosti.

Konvencií

Názov premennej

Názov premennej v knižnici premenných musí spĺňať tieto konvencie:

• Nie je prázdny
• Nemá úvodné ani koncové medzery
• Začína písmenom alebo podčiarknutím
• Môže obsahovať písmená, číslice, podčiarkovníky a spojovníky
• Dĺžka nepresahuje 256 znakov

Názov premennej nerozlišuje veľké a malé písmená.

Keď má premenná definovanú hodnotu, ak sa pokúsite zmeniť jej typ, zobrazí sa dialógové okno súhlasu. Dialógové okno vás upozorní, že všetky hodnoty premenných budú resetované a že táto zmena môže byť zásadnou zmenou na strane spotrebiteľskej položky.

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.