Type tilkoblingsreferansevariabel (forhåndsvisning)

En tilkoblingsreferansevariabel er en arbeidsområdevariabel som lagrer ID-en til en ekstern datatilkobling (for eksempel Snowflake, Azure SQL), noe som gjør det mulig for elementer å referere til eksterne ressurser uten å legge inn legitimasjon eller tilkoblingsstrenger.

Slik bruker du

En tilkoblingsreferansevariabel kan brukes akkurat som andre variabler i et variabelbibliotek.

  1. Logg deg på Fabric.
  2. Naviger til arbeidsområdet og variabelbiblioteket ditt
  3. Øverst velger du + Ny variabel
  4. Oppgi et navn på variabelen, velg tilkoblingsreferanse for typen, og klikk deretter på ... for å velge en verdi

Skjermbilde av elementene som er tilgjengelige for tilkoblingsreferansen. 5. Når du er valgt, skal tilkoblingsreferansen din være klar til bruk.

Skjermbilde av tilkoblingsreferansen.

Hvis du trenger å redigere en tilkoblingsreferanse eller dobbeltsjekke verdien, kan du høyreklikke på verdien for å få opp en popup med informasjon om tilkoblingsreferansen.

Skjermbilde av tilkoblingsreferanse-popupen.

Slik fungerer det

Verdien til en tilkoblingsreferansevariabel er en statisk peker til et tilkoblingsobjekt identifisert ved dens tilkoblings-ID. Verdien lagres som en streng som tilsvarer målforbindelsens ID. Eksempel:

ConnectionID = aaaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Denne ID-en identifiserer entydig den refererte forbindelsen. Den statiske referansen justeres ikke automatisk til ulike pipeline-trinn. Den krever at målforbindelsen eksisterer på tidspunktet for utvelgelsen, og forblir pekt mot den spesifikke forbindelsen med mindre den endres manuelt.

Husk følgende når du jobber med koblingsreferanser:

  • Lagrer en forhåndsdefinert tilkoblingsidentifikator på leietakernivå.
  • Tilkoblingsreferanser bindes ikke automatisk under utrulling. Deres verdier forblir faste på tvers av miljøer.
  • Støtter CI/CD og automatisering ved å parameterisere eksterne tilkoblinger for ulike miljøer (utvikling, test, produksjon).
  • Muliggjør dynamisk konfigurasjon av eksterne relasjoner (for eksempel bytte datakilder eller legitimasjoner per miljø).
  • Verdier velges via en UI-dialog, ikke fri tekst, slik at kun autoriserte tilkoblinger kan velges.
  • Kun tilkoblinger med minst lesetillatelser er tilgjengelige for valg.

Representasjon i Git og API-er

En tilkoblingsreferanse er en avansert variabeltype hvis verdiskjema lagrer connectionId (og plattformen løser/viser metadata). Forfatternyttelasten inkluderer:

  • navn: displayNavnet til tilkoblingsreferansevariabelen
  • Merk: Valgfritt, kan brukes til beskrivelse eller andre notater.
  • type: "connectionReference" (avansert type)
  • verdi: per verdisett lagrer hver verdi { "connectionId": "<GUID/ID-streng>" }

Eksempel:


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

Tillatelser som kreves for å opprette/bruke tilkoblingsreferanser

Bruk av tilkoblingsreferansevariabler innebærer to lag med tillatelser:

  • Opprett og rediger en tilkoblingsreferansevariabel: Brukere med Bidragsyter eller høyere roller i arbeidsområdet kan opprette og redigere variabler i biblioteket, mens Viewers er skrivebeskyttet.
  • Tilgang til tilkoblingsreferansevariabelen: I tillegg til rettigheter på variabelbiblioteket, må du ha minst lesetillatelse på tilkoblingsreferansevariabelen du har tenkt å referere til.

For mer informasjon om tillatelser og tillatelsesvalidering, se Variable library permissions

Støttede elementer

Følgende er en liste over elementer som støtter tilkoblingsreferansevariabler:

Eksempel på Python-kode

Følgende kodeeksempel viser hvordan man bruker en tilkoblingsreferanse i et python-skript.

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

Denne koden gjør følgende:

  • Løser en tilkoblingsreferansevariabel fra et variabelbibliotek i Fabric.
  • Henter tilkoblingsmetadata-objektet
  • Ekstraherer connectionId
  • Skriver ut ID-en slik at den kan brukes i kode- eller API-kall.

Begrensninger

Følgende begrensninger gjelder for tilkoblingsreferansevariabler:

  • Notatbøker støtter ikke innebygde tilkoblinger fordi tilkoblingen connection_id til notatboken ikke er den samme.

Relatert innhold

  • Last updated on