Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A Microsoft Fabric változótára egy speciális elem, amely központosítja a változók definícióját és kezelését, lehetővé téve a munkaterületek és elemek skálázható és automatizált konfigurációját.
A változótárak változói lehetnek alapszintűek vagy speciálisak, és minden változót egyedileg azonosít a kódtárelemen belüli neve.
- A változótár alapszintű változótípusai közé tartoznak az egyszerű adattípusok, például logikai, dátum/idő (ISO 8601 UTC formátumban), guid, egész szám, szám és sztring. Ezek egyszerű értékek, amelyek közvetlenül hozzárendelhetők és használhatók különböző szakaszokban és környezetekben.
- A speciális változótípusok kifinomultabb használati esetekre vannak tervezve, például belső hálóelemekre vagy külső kapcsolatokra való hivatkozásra. Ezek közé tartoznak az "elemhivatkozás" típusok, amelyek a munkaterület és az elem azonosítóit tárolják, hogy meghatározott Fabric elemekre mutassanak.
Támogatott típusok a változótárakban
A változótárakban lévő változók a következő támogatott változótípusokkal rendelkeznek
| TypeType | Kategória | Description |
|---|---|---|
| logikai | Alapszintű | Igaz/hamis értékeket jelöl. |
| Egész szám | Alapszintű | Egész számok tizedesjegyek nélkül. |
| Szám | Alapszintű | Numerikus értékek, beleértve a decimális értékeket is. |
| Lánc | Alapszintű | Szöveges értékek vagy karaktersorozatok. |
| DateTime | Alapszintű | Az ISO 8601 szabvány 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. HH:mm:ss.xxx a kétjegyű óra 24 órás formátumban, amit a kétjegyű perc, a kétjegyű másodperc és a háromjegyű ezredmásodperc követ. Z azt jelzi, hogy az idő az egyezményes világidő (UTC) szerint van. |
| GUID | Alapszintű | Az objektumazonosításhoz használt globálisan egyedi azonosító. |
| Elemhivatkozás | Speciális | A Háló változótárban egy meglévő Hálóelemre – például egy tóházra, jegyzetfüzetre vagy adatfolyamra – mutató hivatkozás tárolására szolgál a munkaterület azonosítójának és az elemazonosítójának tárolásával. |
| Kapcsolat hivatkozás | Speciális | Egy külső adatkapcsolat azonosítóját tároló munkaterület-változó (például Snowflake, Azure SQL), amely lehetővé teszi, hogy az elemek hitelesítő adatok vagy kapcsolati sztringek beágyazása nélkül hivatkozhassanak külső erőforrásokra. |
Változó tulajdonságai
A változótár minden változója a következő tulajdonságokkal rendelkezik:
| Ingatlan | Description |
|---|---|
| Név | A változó egyedi azonosítója. A változó parancsfájlokban vagy munkafolyamatokban való hivatkozására szolgál. |
| Megjegyzés (nem kötelező) | A változóval kapcsolatos leíró megjegyzés vagy jegyzet. Lehetnek környezeti információk, használati megjegyzések vagy speciális utasítások. Maximális hossz: 2048 karakter. |
| Típus | Meghatározza a változó adattípusát (például sztring, egész szám, logikai, tömb). Meghatározza az érték értelmezésének és érvényesítésének módját. |
| Alapértelmezett értékkészlet | A változóhoz rendelt kezdeti érték, ha nincs más érték megadva. Konzisztens viselkedést biztosít a munkafolyamatokban. Az alapértelmezett értékkészlet nem nevezhető át. |
| Alternatív értékkészletek (nem kötelező) | További előre definiált értékkészletek, amelyek meghatározott feltételek vagy forgatókönyvek esetén alkalmazhatók. Környezetspecifikus konfigurációkhoz vagy tartalék beállításokhoz hasznos. |
Elnevezési konvenciók
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.
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.
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.