Del via

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 inn på Microsoft 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 distribusjonsmiljøer. 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 Connection-referanse 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 Fabric Variable-bibliotek
  • 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:

  • Innebygde tilkoblinger i Notebooks støttes ikke siden connection_id for Notebook-tilkoblingen ikke er den samme.

Relatert innhold

  • Last updated on