Typy proměnných v knihovnách

Knihovna proměnných v Microsoft Fabric je specializovaná položka, která centralizuje definici a správu proměnných a umožňuje škálovatelnou a automatizovanou konfiguraci napříč pracovními prostory a položkami.

Proměnné v knihovně proměnných mohou být základní nebo pokročilé typy a každá proměnná je jedinečně identifikována svým názvem v rámci položky knihovny.

• Mezi základní typy proměnných v knihovně proměnných patří jednoduché datové typy, jako jsou Boolean, DateTime (ve formátu ISO 8601 UTC), Guid, Integer, Number a String. Jedná se o jednoduché hodnoty, které je možné přímo přiřadit a použít v různých fázích a prostředích.
• Pokročilé typy proměnných jsou navržené pro sofistikovanější případy použití, například odkazování na interní položky infrastruktury nebo externí připojení. Patří sem typy odkazu na položky, které ukládají ID pracovních prostorů a položek, které odkazují na konkrétní položky systému Fabric.

Podporované typy v knihovnách proměnných

Proměnné v knihovně proměnných mají následující podporované typy proměnných.

TypeType	Kategorie	Description
logický	Basic	Představuje hodnoty true/false.
Integer	Basic	Celá čísla bez desetinných míst.
Number	Basic	Číselné hodnoty včetně desetinných míst.
String	Basic	Textové hodnoty nebo sekvence znaků
DateTime	Basic	Datum a čas reprezentované jako standard ISO 8601 yyyy-MM-ddTHH:mm:ss.xxxZ, kde: yyyy-MM-dd je čtyřciferný rok následovaný dvoumístným měsícem a dvěma číslicemi dne. T odděluje datum a čas. HH:mm:ss.xxx je dvouciferná hodina ve formátu 24 hodin, za kterou následuje dvouciferná minuta, dvouciferná sekunda a třímístná milisekunda. Z označuje, že čas je ve standardu UTC (Coordinated Universal Time).
Průvodce	Basic	Globálně jedinečný identifikátor používaný pro identifikaci jedinečných objektů.
Odkaz na položku	Rozšířený	Používá se v knihovně proměnných Fabric k uložení odkazu na existující položku Fabric, jako je lakehouse, poznámkový blok nebo datový kanál, uložením ID pracovního prostoru a ID položky.
Referenční informace o připojení	Rozšířený	Proměnná pracovního prostoru, která ukládá ID externího datového připojení (například Snowflake, Azure SQL), která umožňuje odkazovat na externí prostředky bez vložení přihlašovacích údajů nebo připojovacích řetězců.

Vlastnosti proměnné

Každá proměnná v knihovně proměnných má následující vlastnosti:

Vlastnictví	Description
Název	Jedinečný identifikátor proměnné. Slouží k odkazování na proměnnou ve skriptech nebo pracovních postupech.
Poznámka (volitelné)	Popisný komentář nebo poznámka k proměnné. Může obsahovat kontext, poznámky k používání nebo zvláštní pokyny. Maximální délka: 2 048 znaků.
Typ	Definuje datový typ proměnné (např. string, integer, boolean, array). Určuje, jak se hodnota interpretuje a ověřuje.
Výchozí sada hodnot	Počáteční hodnota přiřazená proměnné, pokud není zadána žádná jiná hodnota. Zajišťuje konzistentní chování v pracovních postupech. Výchozí sadu hodnot nelze přejmenovat.
Alternativní sady hodnot (volitelné)	Další předdefinované sady hodnot, které lze použít za určitých podmínek nebo scénářů. Užitečné pro konfigurace specifické pro prostředí nebo náhradní možnosti.

Názvoslovné konvence

Název proměnné

Název proměnné uvnitř knihovny proměnných musí odpovídat těmto konvencím:

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

Název proměnné není citlivý na velikost písmen.

Pokud se pokusíte změnit typ proměnné, zobrazí se dialogové okno pro vyjádření souhlasu. Dialogové okno vás upozorní, že všechny hodnoty proměnných budou resetovat a že tato změna může být zásadní změnou na straně položky příjemce.

Ú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ů.