Elemhivatkozási változó típusa (előzetes verzió)

A rugalmasság és a méretezhetőség javítása érdekében speciális változókat vezetünk be a meglévő alapváltozótípusok mellett. Ezek a speciális változók úgy vannak kialakítva, hogy megfeleljenek a legfontosabb követelményeknek, például a külső és belső kapcsolatok paraméterezésének (pl. Snowflake, AWS, OneLake).

A item-referencia változó egy speciális változótípus, amely a Fabric változótárban egy meglévő Fabric 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ó és az elemazonosító tárolásával. Ez a változótípus lehetővé teszi a belső kapcsolat paraméterezését, lehetővé téve a fejlesztők számára, hogy dinamikusan összekapcsolják az elemeket adott Fabric elemekhez az üzembe helyezési szakasz vagy a munkaterület környezete alapján.

A használat módja

Az elemhivatkozási változók ugyanúgy használhatók, mint a változótár más változói.

  1. Bejelentkezés a Microsoft Fabric
  2. Menjen a munkaterületére és a változók könyvtárába
  3. Felül válassza az + Új változó lehetőséget
  4. Adja meg a változó nevét, válassza ki a típus elemhivatkozását , majd kattintson a ... gombra egy érték kiválasztásához
  5. Ekkor megnyílik egy párbeszédpanel a kívánt elem kiválasztásához. Megjelenik az összes olyan elem, amelyen engedélyekkel rendelkezik, és amelyek kiválaszthatóak. A bal oldali explorerrel munkaterület szerint szűrheti a listát. A jobb felső sarokban lévő szűrővel típus szerint szűrhet.

Képernyőkép az elemhivatkozáshoz elérhető elemekről. 6. A kijelölés után így fog megjelenni a varlib oldalon – csak olvasható összetevőként, amely az elem nevét jeleníti meg.

Képernyőkép az elemhivatkozásról.

Ha szerkesztenie kell egy elemhivatkozást, vagy duplán ellenőriznie kell az értéket:

  • további részletek megtekintéséhez kattintson az értékre
  • Az érték vagy más értékhalmazok értékeinek szerkesztéséhez kattintson az érték melletti gombra.

Képernyőkép az elemhivatkozás előugró ablakáról.

Hogyan működik?

Az Elemhivatkozás változó értéke lényegében egy statikus mutató egy Fabric elemhez, amelyet a Munkatér azonosítója + Elemazonosító azonosít. Az érték a célelem munkaterületének és magának az elemnek megfelelő grafikus felhasználói felület párjaként van tárolva. Előfordulhat például, hogy egy hivatkozás belsőleg a következő módon van tárolva:

  • WorkspaceID = aaaaaaaa-0000-1111-2222-bbbbbbbbbb
  • ItemID = 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

Ez a két azonosító együttesen egyedileg azonosítja a hivatkozott elemet.

Az elemhivatkozások használatakor tartsa szem előtt a következőket:

  • Az elemhivatkozások lehetővé teszik a belső kapcsolatparaméterezést, így a fejlesztők dinamikusan csatolják az elemeket adott Fabric erőforrásokhoz az üzembe helyezési szakasz vagy a munkaterület környezete alapján.
  • A hivatkozás statikus, egy adott elemre mutat, és nem igazodik automatikusan a környezetek között.
  • Szakaszspecifikus változatok esetén használjon értékhalmazokat, ahol minden készlet egy másik statikus elemre mutathat (például fázisonként különböző tóházakra).
  • Az értékhalmazok összes értékének azonos elemtípusúnak kell lennie a kompatibilitás biztosítása és a futásidejű hibák megelőzése érdekében. Az értékhalmazok között azonban nem kényszerítjük ki ugyanazt az elemtípust.

Megjelenítés a Gitben és az API-kban

A változótár kódként van kezelve. A Git vagy REST API-k használatával az Elemhivatkozás változók egyértelmű JSON-formátummal rendelkeznek. Minden változó megjelenik a változótár definíciós fájljában (a Gitben tárolva, általában .json), és olyan tulajdonságokat sorol fel, mint a név, a típus és az érték.

Egy elemhivatkozási (statikus) változó esetében az érték a munkaterület és az elemazonosítók strukturált adatai. Példa:


{
 "name": "MyDataLake",
 "note": "",
 "type": "ItemReference",
 "value": {
  "itemId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
 }
}

Az API-val végzett munka során ne feledje a következőket:

  • Csak azonosítók vannak tárolva; a nevek és metaadatok futásidőben kerülnek lekérésre, vagy gyorsítótárazva a Fabric rendszerben.
  • Az API-n keresztüli létrehozás/frissítés munkaterület- és elemazonosítókat biztosít. Az érvénytelen azonosítók hibát okoznak.

Támogatott elemek

Az alábbiakban felsoroljuk azokat az elemeket, amelyek jelenleg elemhivatkozással támogatottak.

Megjegyzés:

A jegyzetfüzet %%configure keresztül nem támogatott.

példakód Python

Az alábbi példakód bemutatja, hogyan használható elemhivatkozás egy Python-szkriptben.

var_ref = "$(/**/VarLibItem/itemReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
workspace_id = var_obj.get("workspaceId").value()
item_id = var_obj.get("itemId").value()
print(workspace_id)
print(item_id)

Ez a kód a következőket teszi:

  • A Fabric változótárból egy elemhivatkozási változó feloldása
  • A hivatkozott elem metaadat-objektumának lekérése
  • Kinyeri a munkaterület azonosítóját és az elemazonosítót
  • Kinyomtatja őket, hogy programozott módon használhatók legyenek.

Az elem referenciaváltozóinak létrehozásához/használatához szükséges engedélyek

Az elemhivatkozási változók használata két engedélyréteget foglal magában:

  • Elemhivatkozási változó létrehozása és szerkesztése: A munkaterületen Közreműködő vagy magasabb szerepkörű felhasználók változókat hozhatnak létre és szerkeszthetnek a könyvtárban, míg a Megtekintők írásvédettek.
  • Az elem-referenciaváltozó elérése: A változótár jogosultságai mellett legalább olvasási engedéllyel kell rendelkeznie a hivatkozni kívánt elemhivatkozási változóhoz .

További információ az engedélyekről és az engedélyek érvényesítéséről: Változótár engedélyei

Korlátozások

Jelenleg csak hálóelemekre és szemantikai modellekre hivatkozhat. Az egyéb Power BI elemek, például az Adatfolyam Gen1 jelenleg nem támogatottak.

További információk

A változótár lehetővé teszi a Fabric tartalom CI/CD használatát különböző környezetekben (Dev, Test, Prod), az elemhivatkozási változók alkalmazásával a szakaszspecifikus konfigurációkhoz. Tartsa szem előtt a következőket:

  • Az elemhivatkozások egy adott munkaterülethez és elemazonosítóhoz vannak kötve.
  • Az új fázisban történő üzembe helyezéskor ezek a hivatkozások továbbra is az eredeti munkaterületre mutatnak, hacsak nem frissítik manuálisan.
  • Használjon több értékkészletet mindegyik fázishoz, és aktiválja a megfelelő készletet manuálisan vagy API-szkriptek használatával.

További információ: értékhalmazok a változótárakban.

Kapcsolódó tartalom

  • Last updated on