Dela via

Typ av anslutningsreferensvariabel (förhandsversion)

En anslutningsreferensvariabel är en arbetsytevariabel som lagrar ID :t för en extern dataanslutning (till exempel Snowflake, Azure SQL) så att objekt kan referera till externa resurser utan att bädda in autentiseringsuppgifter eller anslutningssträngar.

Så här använder du

En anslutningsreferensvariabel kan användas precis som andra variabler i ett variabelbibliotek.

  1. Logga in på Microsoft Fabric
  2. Navigera till arbetsytan och variabelbiblioteket
  3. Längst upp väljer du + Ny variabel
  4. Ange ett namn för variabeln, välj anslutningsreferens för typen och klicka sedan på ... för att välja ett värde

Skärmbild av de objekt som är tillgängliga för anslutningsreferensen. 5. När du har valt bör anslutningsreferensen vara klar att användas.

Skärmbild av anslutningsreferensen.

Om du behöver redigera en anslutningsreferens eller behöver dubbelkolla värdet kan du högerklicka på värdet för att visa ett popup-fönster med information om anslutningsreferensen.

Skärmbild av anslutningsreferens-popupfönstret.

Så här fungerar det

En anslutningsreferensvariabels värde är en statisk pekare till ett anslutningsobjekt som identifieras av dess anslutnings-ID. Värdet lagras som en sträng som motsvarar målanslutningens ID. Som exempel:

ConnectionID = aaaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Det här ID:t identifierar unikt den refererade anslutningen. Den statiska referensen justeras inte automatiskt till olika distributionsmiljöer. Den kräver att målanslutningen finns vid tidpunkten för valet och förblir pekad på den specifika anslutningen om den inte ändras manuellt.

Tänk på följande när du arbetar med anslutningsreferenser:

  • Lagrar en fördefinierad anslutningsidentifierare på klientorganisationsnivå.
  • Anslutningsreferenser binder inte automatiskt vid distribution. Deras värden förblir fasta i olika miljöer.
  • Stöder CI/CD och automatisering genom att parameterisera externa anslutningar för olika miljöer (dev, test, prod).
  • Aktiverar dynamisk konfiguration av externa relationer (till exempel att växla datakällor eller autentiseringsuppgifter per miljö).
  • Värden väljs via en dialogruta för användargränssnittet, inte fritext, vilket säkerställer att endast auktoriserade anslutningar kan väljas.
  • Endast anslutningar med minst läsbehörighet är tillgängliga för val.

Representation i Git och API:er

En anslutningsreferens är en avancerad variabeltyp vars värdeschema lagrar connectionId (och plattformen löser/visar metadata). Redigeringsnyttolasten innehåller:

  • name: "displayName" för anslutningsreferensvariabeln
  • Obs! Valfritt, kan användas för beskrivning eller andra anteckningar.
  • typ: "connectionReference" (avancerad typ)
  • värde: per värdeuppsättning lagrar varje värde { "connectionId": "<GUID/ID-sträng>" }

Exempel:


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

Behörigheter som krävs för att skapa/använda anslutningsreferenser

Användning av anslutningsreferensvariabler omfattar två behörighetsnivåer:

  • Skapa och redigera en anslutningsreferensvariabel: Användare med Collaborator eller högre roller på arbetsytan kan skapa och redigera variabler i biblioteket, medan Granskare endast har läsrättigheter.
  • Åtkomst till anslutningsreferensvariabeln: Förutom rättigheter för variabelbiblioteket måste du ha minst läsbehörighet för anslutningsreferensvariabeln som du tänker referera till.

Mer information om behörigheter och behörighetsverifiering finns i Variabelbiblioteksbehörigheter

Objekt som stöds

Följande är en lista över objekt som stöder anslutningsreferensvariabler:

Python-kodexempel

I följande kodexempel visas hur du använder en anslutningsreferens i ett Python-skript.

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

Den här koden gör följande:

  • Löser en anslutningsreferensvariabel från ett infrastrukturvariabelbibliotek
  • Hämtar objektet för anslutningsmetadata
  • Extraherar "connectionId"
  • Skriver ut ID:t så att det kan användas i kod- eller API-anrop.

Begränsningar

Följande begränsningar gäller för anslutningsreferensvariabler:

  • Inbyggda anslutningar i Notebook-filer stöds inte eftersom connection_id för Notebook-anslutningen inte är densamma.

Relaterat innehåll

  • Last updated on