Typ referenčnej premennej spojenia (náhľad)

Referenčná premenná spojenia je premenná pracovného priestoru, ktorá uchováva ID externého dátového spojenia (napríklad Snowflake, Azure SQL), čo umožňuje položkám odkazovať na externé zdroje bez vkladania prihlasovacích údajov alebo reťazcov spojenia.

Použitie

Referenčná premenná spojenia 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 referenciu spojenia pre typ a potom kliknite na ... na výber hodnoty

Snímka obrazovky dostupných položiek pre referenciu pripojenia. 5. Po výbere by mala byť vaša referencia na spojenie pripravená na použitie.

Screenshot odkazu na pripojenie.

Ak potrebujete upraviť referenciu spojenia alebo skontrolovať hodnotu, môžete kliknutím pravým tlačidlom na hodnotu zobraziť vyskakovacie okno s informáciami o referencii spojenia.

Screenshot vyskakovacieho okna referencie na pripojenie.

Ako to funguje

Hodnota referenčnej premennej spojenia je statický ukazovateľ na objekt spojenia identifikovaný jeho ID spojenia. Hodnota je uložená ako reťazec zodpovedajúci ID cieľového spojenia. Príklad:

ConnectionID = aaaaa-0000-1111-2222-bbbbbbbb

Toto ID jednoznačne identifikuje odkazované spojenie. Statická referencia sa automaticky neprispôsobuje rôznym fázam pipeline. Vyžaduje, aby cieľové spojenie existovalo v čase výberu a zostáva nasmerované na toto konkrétne pripojenie, pokiaľ nie je manuálne zmenené.

Majte na pamäti nasledujúce pri práci s referenciami spojení:

  • Ukladá preddefinovaný identifikátor pripojenia na úrovni tenanta.
  • Referencie na pripojenie sa počas nasadenia automaticky neviažu. Ich hodnoty zostávajú pevné naprieč prostredím.
  • Podporuje CI/CD a automatizáciu parametrizáciou externých pripojení pre rôzne prostredia (vývoj, testovanie, produkcia).
  • Umožňuje dynamickú konfiguráciu externých vzťahov (napríklad prepínanie zdrojov dát alebo prihlasovacích údajov v rámci prostredia).
  • Hodnoty sa vyberajú cez dialóg používateľského rozhrania, nie voľný text, čím sa zabezpečuje, že sú dostupné len autorizované pripojenia.
  • Na výber sú dostupné len pripojenia s aspoň oprávnením na čítanie.

Reprezentácia v Git a API

Referencia spojenia je pokročilý typ premennej, ktorého schéma hodnôt ukladá connectionId (a platforma rieši/zobrazuje metadáta). Autorský payload zahŕňa:

  • názov: displejNázov referenčnej premennej spojenia
  • Poznámka: voliteľné, môže sa použiť na popis alebo iné poznámky.
  • typ: "connectionReference" (pokročilý typ)
  • value: na množinu hodnôt, každá hodnota ukladá { "connectionId": "<GUID/ID string>" }

Príklad:


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

Povolenia potrebné na vytváranie/používanie referencií spojení

Použitie referenčných premenných spojenia zahŕňa dve vrstvy oprávnení:

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

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

Podporované položky

Nasleduje zoznam položiek, ktoré podporujú referenčné premenné spojenia:

Príklad Python kódu

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

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

Tento kód robí nasledovné:

  • Vyrieši referenčnú premennú spojenia z knižnice premenných v Fabric.
  • Obnoví metadáta spojenia
  • Extrahuje connectionId
  • Vytlačí ID, aby sa dalo použiť v kóde alebo v API volaniach.

Obmedzenia

Na referenčné premenné spojenia platia nasledujúce obmedzenia:

  • Notebooky nepodporujú zabudované pripojenia, pretože connection_id pripojenie k notebooku nie je to isté.

Súvisiaci obsah

  • Last updated on