Názvy a typy proměnných

Položka knihovny proměnných v Microsoft Fabric obsahuje seznam proměnných a jejich výchozí hodnoty. Může také obsahovat další sady hodnot, které obsahují alternativní hodnoty.

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

• Název
• Poznámka (volitelné), až 2 048 znaků
• Typ
• Výchozí sada hodnot
• Alternativní sady hodnot (volitelné)

Názvoslovné konvence

Název knihovny proměnných

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.

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.

Název sady hodnot

Názvy množiny hodnot mají stejná omezení jako názvy proměnných.

Typy proměnných

Než budete moct do proměnné přidat hodnotu, musíte definovat typ proměnné. Proměnné v knihovně proměnných můžou být některé z následujících typů:

• Řetězec: Libovolný znak. Může být nebo může být null prázdný.

• Logická hodnota: True nebo False.

• DateTime: 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).

  Příklad: 2025-01-14T16:15:20.123Z.

• Číslo: Libovolné číslo.

• GUID: Globálně jedinečný identifikátor.

• Celé číslo: Celé číslo, které může být kladné, záporné nebo nulové.

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.

Alternativní sady hodnot

Když vytvoříte novou sadu hodnot v knihovně proměnných, nové hodnoty se nastaví jako ukazatele na výchozí hodnoty. Můžete je změnit na pevnou hodnotu.

Pokud změníte hodnotu proměnné v alternativní sadě hodnot, uloží se alternativní hodnota do souboru JSON pro sady hodnot. Můžete změnit pořadí, ve kterém se zobrazí sady hodnot, nebo změnit hodnotu proměnné v alternativní sadě hodnot v tomto souboru JSON v Gitu.

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

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ždy existuje jedna (a pouze jedna) aktivní hodnota nastavená v knihovně proměnných najednou. 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.