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).

Proměnná item reference je pokročilý typ proměnné používaný v knihovně proměnných Fabric k uložení odkazu na existující položku v rámci Fabric, jako je lakehouse, poznámkový blok nebo datová pipeline, 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 Fabric položkami 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řihlaste se k 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ý ukazatel na položku Fabric identifikovanou pomocí Workspace ID + 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 = aaaaaa-0000-1111-2222-bbbbbbbb
  • ItemID = 00aa00aa-bb11-cc22-dd33-44ee44ee

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 Fabric prostředky 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

Spravujte knihovnu proměnných jako kód. Použitím Git nebo REST API můžete pracovat s proměnnými reference položek přes jasný JSON formát. Všechny proměnné se objevují v souboru definice knihovny proměnných (uloženém v Gitu, obvykle .json), kde jsou uvedeny vlastnosti jako název, typ a hodnota.

Pro proměnnou pro referenční (statickou) položku je hodnotou strukturovaná data pro pracovní prostor a ID 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 v mezipaměti v 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 Python

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í:

  • Vyřeší referenční proměnnou položky z knihovny proměnných ve 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é Power BI položky, jako je Dataflow Gen1, se v současné době nepodporují.

Další informace

Knihovna proměnných umožňuje CI/CD pro obsah Fabric napříč prostředími (Dev, Test, Prod) použitím referenčních proměnných pro specifické konfigurace jednotlivých fází. Mějte na paměti následující skutečnosti:

  • Reference na položky jsou vázány na konkrétní pracovní prostor 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ě.
  • Použijte více hodnotových sad pro každou fázi a aktivujte správnou sadu ručně nebo pomocí API skriptů.

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

Související obsah

  • Last updated on