Sdílet prostřednictvím

Typ referenční proměnné připojení (Preview)

Referenční proměnná připojení je proměnná pracovního prostoru, která ukládá ID externího datového připojení (například Snowflake, Azure SQL) a umožňuje položkám odkazovat na externí prostředky bez vložení přihlašovacích údajů nebo připojovacích řetězců.

Způsob použití

Referenční proměnnou připojení 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 připojení pro typ a potom kliknutím na tlačítko ... vyberte hodnotu.

Snímek obrazovky s položkami dostupnými pro odkaz na připojení 5. Po výběru by odkaz na připojení měl být připravený k použití.

Snímek obrazovky s odkazem na připojení

Pokud potřebujete upravit odkaz na připojení nebo potřebujete hodnotu zkontrolovat, můžete na hodnotu kliknout pravým tlačítkem myši a zobrazit automaticky otevírané okno s informacemi o odkazu na připojení.

Snímek obrazovky s vyskakovacím oknem s odkazem na připojení.

Jak to funguje

Hodnota referenční proměnné připojení je statický ukazatel na objekt připojení, který je identifikován jeho ID připojení. Hodnota je uložena jako řetězec odpovídající ID cílového připojení. Například:

ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Toto ID jednoznačně identifikuje odkazované připojení. Statický odkaz se automaticky neupravuje do různých prostředí nasazení. Vyžaduje, aby cílové připojení existovalo v době výběru a zůstalo směrováno na toto konkrétní připojení, dokud ho ručně nezměníte.

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

  • Ukládá předdefinovaný identifikátor připojení na úrovni tenanta.
  • Odkazy na připojení se během nasazování automaticky neváže. Jejich hodnoty zůstávají pevné napříč prostředími.
  • Podporuje CI/CD a automatizaci pomocí parametrizace externích připojení pro různá prostředí (vývoj, testování, prod).
  • Umožňuje dynamickou konfiguraci externích relací (například přepínání zdrojů dat nebo přihlašovacích údajů na prostředí).
  • Hodnoty jsou vybrány prostřednictvím dialogového okna uživatelského rozhraní, nikoli volného textu, čímž se zajistí, že se dají vybrat pouze autorizovaná připojení.
  • Pro výběr jsou k dispozici pouze připojení s alespoň oprávněními ke čtení.

Reprezentace v Gitu a rozhraních API

Odkaz na připojení je pokročilý typ proměnné, jehož schéma hodnoty ukládá connectionId (a platforma zpracovává nebo zobrazuje metadata). Datová část pro vytváření obsahu zahrnuje:

  • name: displayName proměnné referenčního připojení
  • poznámka: Volitelné, lze použít pro popis nebo jiné poznámky.
  • type: "connectionReference" (rozšířený typ)
  • hodnota: pro každou množinu hodnot, každá hodnota ukládá { "connectionId": "<GUID/ID řetězec>" }

Příklad:


  {
   "name": "PrimaryDb",
   "note": "",
   "type": "connectionReference",
   "value": { "connectionId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" }
  }

Oprávnění požadovaná k vytvoření nebo použití odkazů na připojení

Použití referenčních proměnných pro připojení zahrnuje dvě vrstvy oprávnění:

  • Vytvoření a úprava proměnné referenčního připojení: Uživatelé s rolemi Přispěvatel nebo vyšší v pracovním prostoru mohou vytvářet a upravovat proměnné v knihovně, zatímco diváci mají pouze přístup pro čtení.
  • Přístup k referenční proměnné připojení: Kromě práv v knihovně proměnných musíte mít alespoň oprávnění ke čtení pro referenční proměnnou připojení , 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.

Podporované položky

Následuje seznam položek, které podporují referenční proměnné připojení:

Příklad kódu Pythonu

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

var_ref = "$(/**/VarLibItem/ConnectionReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
connection_id = var_obj.get("connectionId").value()
print(connection_id)

Tento kód provede následující:

  • Řeší referenční proměnnou připojení z knihovny proměnných Fabric.
  • Načte objekt metadat připojení.
  • Extrahuje ID připojení.
  • Vytiskne ID, aby bylo možné ho použít ve volání kódu nebo rozhraní API.

Omezení

Pro referenční proměnné připojení platí následující omezení:

  • Integrovaná připojení v poznámkových blocích nejsou podporována, protože connection_id pro připojení poznámkového bloku není stejný.

Související obsah

  • Last updated on