Typ referenčnej premennej položky (náhľad)

Aby sme zvýšili flexibilitu a škálovateľnosť, zavádzame pokročilé premenné vedľa existujúcich základných typov premenných. Tieto pokročilé premenné sú navrhnuté tak, aby spĺňali kľúčové požiadavky, ako je parametrizácia externých a vnútorných spojení (napr. Snowflake, AWS, OneLake).

Premenná item reference je pokročilý typ premennej používaný v Fabric Variable Library na uchovávanie referencie na existujúcu Fabric položku – napríklad lakehouse, zápisník alebo dátový pipeline – uložením jej workspace ID a item ID. Tento typ premennej umožňuje parametrizáciu interného spojenia, čo vývojárom umožňuje dynamicky prepojiť položky s konkrétnymi položkami Fabric na základe fázy nasadenia alebo kontextu pracovného priestoru.

Použitie

Referenčná premenná položky môže byť použitá rovnako ako iné premenné v knižnici premenných.

  1. Prihláste sa do služby Fabric.
  2. Prejdite do svojho pracovného priestoru a knižnice premenných
  3. V hornej časti vyberte + Nová premenná
  4. Zadajte názov premennej, vyberte položku referenciu pre typ a potom kliknite na ... na výber hodnoty
  5. Tým sa otvorí dialóg na výber požadovanej položky. Uvidíte všetky položky, na ktoré máte povolenia, dostupné na výber. Použite prieskumník vľavo na filtrovanie zoznamu podľa pracovného priestoru. Použite filter v pravom hornom rohu na filtrovanie podľa typu.

Snímka obrazovky položiek dostupných pre referenciu predmetu. 6. Po výbere sa zobrazí na stránke varlib – ako komponent iba na čítanie s názvom položky.

Snímka obrazovky odkazu na predmet.

Ak potrebujete upraviť referenciu položky alebo si overiť hodnotu:

  • Pre viac informácií kliknite na hodnotu
  • Na úpravu tejto hodnoty alebo hodnôt iných množín hodnôt kliknite na tlačidlo vedľa hodnoty.

Screenshot vyskakovacieho okna s referenciou na predmet.

Ako to funguje

Hodnota referenčnej premennej položky je v podstate statický ukazovateľ na položku Fabric identifikovanú podľa Workspace ID + ID položky. Hodnota je uložená ako dvojica GUID zodpovedajúcich pracovnému priestoru cieľovej položky a samotnej položke. Napríklad referencia môže byť interne uložená ako:

  • WorkspaceID = aaaaa-0000-1111-2222-bbbbbbbb
  • ItemID = 00aa00aa-bb11-cc22-dd33-44ee44e44ee

Tieto dve ID spolu jednoznačne identifikujú odkazovanú položku.

Majte na pamäti nasledujúce pri práci s referenciami na položky:

  • Referencie položiek umožňujú parametrizáciu interného spojenia, čo vývojárom umožňuje dynamicky prepojiť položky so špecifickými zdrojmi Fabric na základe kontextu fázy nasadenia alebo pracovného priestoru.
  • Referencia je statická, ukazuje na konkrétny predmet a neprispôsobuje sa automaticky naprieč prostredím.
  • Pre variácie špecifické pre jednotlivé etapy použite hodnotové množiny, kde každá sada môže smerovať na iný statický predmet (napr. rôzne jazerné domčeky v každej úrovni).
  • Všetky hodnoty naprieč množinami hodnôt by mali byť rovnakého typu položky, aby sa zabezpečila kompatibilita a predišlo chybám počas behu. Avšak nevynucujeme mať rovnaký typ položky naprieč množinami hodnôt.

Reprezentácia v Git a API

Spravujte knižnicu premenných ako kód. Použitím Git alebo REST API môžete pracovať s referenčnými premennými položiek cez jasný formát JSON. Všetky premenné sa zobrazujú v súbore definície knižnice premenných (uloženom v Gite, zvyčajne .json), kde sú uvedené vlastnosti ako názov, typ a hodnota.

Pre referenčnú (statickú) premennú položky je hodnotou štruktúrované údaje pre pracovný priestor a ID položiek. Príklad:


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

Pri práci cez API nezabudnite na nasledovné:

  • Ukladajú sa iba ID; mená a metadáta sa získavajú za behu alebo ukladajú do vyrovnávacej pamäte v Fabric.
  • Pri vytváraní/aktualizácii cez API poskytujete pracovné priestory a ID položiek. Neplatné ID spôsobujú chyby.

Podporované položky

Nasleduje zoznam položiek, ktoré sú momentálne podporované pomocou referencií položiek:

Note

Notebook nie %%configure je podporovaný.

Príklad Python kódu

Nasledujúci príklad kódu ukazuje, ako použiť referenciu na položku v python skripte.

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)

Tento kód robí nasledovné:

  • Rieši referenčnú premennú položky z knižnice premenných v Fabric.
  • Získa metadátový objekt pre daný referenčný predmet
  • Extrahuje ID pracovného priestoru a ID položky
  • Tlačí ich, aby sa dali použiť programovane.

Povolenia potrebné na vytváranie/používanie referenčných premenných položiek

Používanie referenčných premenných položiek zahŕňa dve vrstvy oprávnení:

  • Vytvoriť a upraviť referenčnú premennú položky: Používatelia s rolami Prispievateľ alebo vyššími v pracovnom priestore môžu vytvárať a upravovať premenné v knižnici, zatiaľ čo Prehliadače sú len na čítanie.
  • Prístup k referenčnej premennej položky: Okrem práv na knižnicu premenných musíte mať aspoň povolenie na čítanie na referenčnú premennú položky , na ktorú chcete odkazovať.

Pre viac informácií o oprávneniach a overovaní oprávnení pozri Práva knižníc premenných

Obmedzenia

Momentálne môžete odkazovať len na predmety tkaniny a sémantické modely. Iné položky Power BI, ako napríklad Dataflow Gen1, momentálne nie sú podporované.

Ďalšie informácie

Knižnica premenných umožňuje CI/CD pre Fabric obsah naprieč prostrediami (Dev, Test, Prod) použitím referenčných premenných položiek pre konfigurácie špecifické pre jednotlivé fázy. Majte na pamäti nasledujúce body:

  • Referencie položiek sú viazané na konkrétny pracovný priestor a ID položky.
  • Pri nasadení do novej fázy tieto odkazy stále ukazujú na pôvodný pracovný priestor, pokiaľ nie sú manuálne aktualizované.
  • Používajte viacero hodnotových sad pre každú fázu a aktivujte správnu sadu manuálne alebo cez API skripty.

Pre viac informácií pozri hodnotové množiny v knižniciach premenných.

Súvisiaci obsah

  • Last updated on