Változónevek és típusok

A Microsoft Fabric változótárelemei a változók listáját és alapértelmezett értékeit tartalmazzák. Más értékhalmazokat is tartalmazhat, amelyek más értékeket tartalmaznak.

A változótár minden változója a következő tulajdonságokkal rendelkezik:

• Név
• Megjegyzés (nem kötelező), legfeljebb 2048 karakter
• Típus
• Alapértelmezett értékkészlet
• Alternatív értékkészletek (nem kötelező)

Elnevezési konvenciók

Változó kódtár neve

Magának a változótárelemnek a neve az alábbi konvenciók szerint történik:

• Nem üres
• Nincsenek bevezető vagy záró szóközök
• Betűvel kezdődik
• Tartalmazhat betűket, számokat, aláhúzásjeleket, kötőjeleket és szóközöket
• Nem hosszabb 256 karakternél

A változótár neve nem megkülönbözteti a kis- és nagybetűk nevét.

Változó neve

A változótárban lévő változó nevének az alábbi konvenciókat kell követnie:

• Nem üres
• Nincsenek bevezető vagy záró szóközök
• Betűvel vagy aláhúzásjellel kezdődik
• Tartalmazhat betűket, számokat, aláhúzásjeleket és kötőjeleket
• Nem hosszabb 256 karakternél

A változó neve nem kis- és nagybetű érzékeny.

Értékkészlet neve

Az értékhalmaznevekre ugyanazok a korlátozások vonatkoznak, mint a változónevekre.

Változótípusok

Mielőtt értéket adhat egy változóhoz, meg kell határoznia a változó típusát. A változótár változói az alábbi típusok bármelyikét tartalmazhatják:

• Karakterlánc: Bármely karakter. Lehet vagy null üres.

• Logikai: True vagy False.

• DateTime: Az ISO 8601 standard yyyy-MM-ddTHH:mm:ss.xxxZ szabványként megadott dátum és idő, ahol:

  • A yyyy-MM-dd a négyjegyű év, amelyet a kétjegyű hónap és a kétjegyű nap követ.
  • T elválasztja a dátumot és az időpontot.
  • Óó:mm:ss.xxx a kétjegyű óra 24 órás formátumban, majd a kétjegyű perc, a kétjegyű másodperc és a háromjegyű ezredmásodperc.
  • Z azt jelzi, hogy az idő az egyezményes világidő (UTC) szerint van.

  Például: 2025-01-14T16:15:20.123Z.

• Szám: Tetszőleges szám.

• GUID: Globálisan egyedi azonosító.

• Egész szám: Egy egész szám, amely lehet pozitív, negatív vagy nulla.

Ha egy változó definiált értékkel rendelkezik, ha megpróbálja módosítani a típusát, megjelenik egy hozzájárulási párbeszédpanel. A párbeszédpanel figyelmezteti, hogy az összes változóérték alaphelyzetbe lesz állítva, és hogy ez a változás a fogyasztói elem oldalán kompatibilitástörő változás lehet.

Alternatív értékkészletek

Amikor új értékkészletet hoz létre egy változótárban, az új értékek az alapértelmezett értékekre mutatóként lesznek beállítva. Módosíthatja őket rögzített értékként.

Ha módosítja egy változó értékét az alternatív értékhalmazban, az alternatív érték az értékhalmazok JSON-fájljában lesz mentve. A Gitben található JSON-fájlban módosíthatja az értékhalmazok megjelenési sorrendjét, vagy módosíthatja egy változó értékét az alternatív értékkészletben.

Szempontok és korlátozások

Méretkorlátozások

• Legfeljebb 1000 változó és akár 1000 értékkészlet is lehet, amennyiben megfelel mindkét követelménynek:

  • Az alternatív értékhalmazokban lévő cellák teljes száma kevesebb, mint 10 000.
  • Az elem mérete nem haladja meg az 1 MB-ot.

  Ezek a követelmények a módosítások mentésekor lesznek érvényesítve.

• A jegyzetmező legfeljebb 2048 karakter hosszúságú lehet.

• Az értékhalmaz leírásmezője legfeljebb 2048 karakter hosszúságú lehet.

Alternatív értékkészletek korlátozásai

• A változótár alternatív értékhalmazai abban a sorrendben jelennek meg, amelyben hozzáadta őket. Jelenleg nem rendezheti át őket a felhasználói felületen. A sorrend módosításához szerkessze közvetlenül a JSON-fájlt.
• Az egyes értékhalmazok nevének egyedinek kell lennie egy változótárban.
• A változóneveknek egyedinek kell lenniük egy változótárban. Egy munkaterületen két azonos nevű változót is használhat, ha különböző elemeket tartalmaz.
• A változótárakban mindig egy (és csak egy) aktív érték van beállítva egyszerre. Aktív értékhalmaz nem törölhető. A törléshez először konfiguráljon egy másik értékkészletet aktívként. Az üzembehelyezési folyamat minden szakaszához eltérő aktív érték állítható be.