Sdílet prostřednictvím

Typ proměnné odkazu na položku (Preview)

Abychom zvýšili flexibilitu a škálovatelnost, zavádíme pokročilé proměnné spolu s existujícími základními typy proměnných. Tyto pokročilé proměnné jsou navržené tak, aby splňovaly klíčové požadavky, jako je parametrizace externích a interních připojení (např. Snowflake, AWS, OneLake).

Referenční proměnná položky je rozšířený typ proměnné používaný v knihovně proměnných Fabric k uložení odkazu na existující položku Fabric, jako je lakehouse, poznámkový blok nebo datový kanál, uložením ID pracovního prostoru a ID položky. Tento typ proměnné umožňuje interní parametrizaci připojení, což vývojářům umožňuje dynamicky propojit položky s konkrétními položkami infrastruktury na základě fáze nasazení nebo kontextu pracovního prostoru.

Způsob použití

Referenční proměnnou položky lze použít stejně jako jiné proměnné v knihovně proměnných.

  1. Přihlášení k Microsoft Fabric
  2. Přejděte do pracovního prostoru a knihovny proměnných
  3. Nahoře vyberte + Nová proměnná
  4. Zadejte název proměnné, vyberte odkaz na položku pro typ a potom kliknutím na tlačítko ... vyberte hodnotu.
  5. Otevře se dialogové okno pro výběr požadované položky. Zobrazí se všechny položky, u kterých máte oprávnění, k dispozici pro výběr. Pomocí průzkumníka vlevo vyfiltrujte seznam podle pracovního prostoru. Pomocí filtru v pravém horním rohu můžete filtrovat podle typu.

Snímek obrazovky s položkami dostupnými pro odkaz na položku 6. Po výběru se na stránce varlib zobrazí jako součást určená jen pro čtení s názvem položky.

Snímek obrazovky s odkazem na položku

Pokud potřebujete upravit odkaz na položku nebo je potřeba tuto hodnotu pečlivě zkontrolovat:

  • kliknutím na hodnotu zobrazíte další podrobnosti.
  • chcete-li upravit tuto hodnotu nebo hodnoty jiných sad hodnot, klikněte na tlačítko vedle hodnoty.

Snímek obrazovky vyskakovacího okna s referencí k položce.

Jak to funguje

Hodnota referenční proměnné položky je v podstatě statickým ukazatelem na položku Fabric, identifikovanou pomocí ID pracovního prostoru + ID položky. Hodnota se uloží jako dvojice identifikátorů GUID odpovídajících pracovnímu prostoru cílové položky a samotné položce. Odkaz může být například uložen interně jako:

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

Tyto dvě ID společně jednoznačně identifikují odkazovanou položku.

Při práci s odkazy na položky mějte na paměti následující skutečnosti:

  • Odkazy na položky umožňují interní parametrizaci připojení, což vývojářům umožňuje dynamicky propojit položky s konkrétními prostředky infrastruktury na základě fáze nasazení nebo kontextu pracovního prostoru.
  • Odkaz je statický, odkazuje na konkrétní položku a automaticky se neupravuje v různých prostředích.
  • Pro varianty specifické pro fáze použijte sady hodnot, kde každá sada může odkazovat na jinou statickou položku (např. různé lakehouses pro každou fázi).
  • Všechny hodnoty v sadách hodnot by měly být stejného typu položky, aby se zajistila kompatibilita a zabránila chybám za běhu. Nevynucujeme ale stejný typ položky napříč sadami hodnot.

Reprezentace v Gitu a rozhraních API

Knihovna proměnných se spravuje jako kód. Pomocí gitu nebo rozhraní REST API mají proměnné reference k položkám jasný formát JSON. Všechny proměnné se zobrazí v definičním souboru knihovny proměnných (uloženém v Gitu, obvykle .json), výpisu vlastností, jako je název, typ a hodnota.

Pro proměnnou typu Odkaz na položku (statická) jsou hodnotou strukturovaná data ID pracovních prostorů a položek. Příklad:


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

Při práci přes rozhraní API si zapamatujte následující skutečnosti:

  • Ukládají se pouze ID; názvy a metadata se načítají za běhu nebo se ukládají do mezipaměti ve Fabric.
  • Při vytváření/aktualizaci prostřednictvím rozhraní API zadáte ID pracovního prostoru a položky. Neplatná ID způsobují chyby.

Podporované položky

Následuje seznam položek, které jsou aktuálně podporovány pomocí odkazu na položku:

Poznámka:

Notebook prostřednictvím %%configure není podporován.

Příklad kódu Pythonu

Následující příklad kódu ukazuje, jak použít odkaz na položku ve skriptu Pythonu.

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 provede následující:

  • Řeší proměnnou referenční položky z knihovny proměnných Fabric.
  • Načte objekt metadat pro tuto odkazovanou položku.
  • Extrahuje ID pracovního prostoru a ID položky.
  • Vytiskne je, aby je bylo možné použít programově.

Oprávnění Požadovaná k vytvoření nebo použití referenčních proměnných položek

Použití referenčních proměnných položek zahrnuje dvě vrstvy oprávnění:

  • Vytvářet a upravovat referenční proměnnou položky: Uživatelé s rolemi Přispěvatel nebo vyššími v pracovním prostoru mohou vytvářet a upravovat proměnné v knihovně, zatímco Zobrazující mají přístup pouze pro čtení.
  • Přístup k referenční proměnné položky: Kromě práv ke knihovně proměnných musíte mít alespoň oprávnění pro čtení referenční proměnné položky, na kterou chcete odkazovat.

Další informace o oprávněních a ověřování oprávnění najdete v tématu Oprávnění knihovny proměnných.

Omezení

V současné době můžete odkazovat pouze na položky fabric a sémantické modely. Jiné položky Power BI, jako jsou datamarty a Dataflow Gen1, nejsou v současné době podporovány.

Další informace

Knihovna proměnných umožňuje CI/CD pro Fabric obsah napříč prostředími (Vývoj, Testování, Produkce) s využitím odkazových proměnných pro konfigurace specifické pro dané fáze. Mějte na paměti následující skutečnosti:

  • Odkazy na položky jsou svázané s konkrétním pracovním prostorem a ID položky.
  • Při nasazení do nové fáze tyto odkazy stále směřují na původní pracovní prostor, pokud se neaktualizují ručně.
  • Pro každou fázi použijte více Value-Sets a aktivujte správnou sadu ručně nebo pomocí skriptů rozhraní API.

Další informace najdete v tématu sady hodnot v knihovnách proměnných.

Související obsah

  • Last updated on