Del via

Forbindelsesreferencevariabeltype (forhåndsvisning)

En forbindelsesreferencevariabel er en arbejdsområdevariabel, der gemmer ID'et for en ekstern dataforbindelse (for eksempel Snowflake, Azure SQL), hvilket gør det muligt for elementer at referere til eksterne ressourcer uden at indlejre legitimationsoplysninger eller forbindelsesstrenge.

Sådan bruger du

En forbindelsesreferencevariabel kan bruges ligesom andre variable i et variabelbibliotek.

  1. Log ind på Microsoft Fabric
  2. Navigér til dit arbejdsområde og variabelbibliotek
  3. Øverst vælger du + Ny variabel
  4. Angiv et navn til variablen, vælg forbindelsesreference for typen, og klik derefter på ... for at vælge en værdi

Skærmbillede af de tilgængelige elementer til forbindelsesreferencen. 5. Når den er valgt, skal din forbindelsesreference være klar til brug.

Skærmbillede af forbindelsesreferencen.

Hvis du skal redigere en forbindelsesreference eller dobbelttjekke værdien, kan du højreklikke på værdien for at få en pop-up op med information om forbindelsesreferencen.

Skærmbillede af forbindelsesreference-popupen.

Sådan fungerer det

En forbindelsesreferencevariabels værdi er en statisk peger til et forbindelsesobjekt, der identificeres ved dets forbindelses-ID. Værdien gemmes som en streng, der svarer til målforbindelsens ID. Eksempel:

ConnectionID = aaaaa-0000-1111-2222-bbbbbbbbbbbb

Dette ID identificerer entydigt den refererede forbindelse. Den statiske reference justeres ikke automatisk til forskellige deploymiljøer. Den kræver, at målforbindelsen eksisterer på tidspunktet for udvælgelsen og forbliver peget mod den specifikke forbindelse, medmindre den ændres manuelt.

Husk følgende, når du arbejder med forbindelsesreferencer:

  • Gemmer en foruddefineret forbindelsesidentifikator på lejerniveau.
  • Forbindelsesreferencer binder ikke automatisk under udrulning. Deres værdier forbliver faste på tværs af miljøer.
  • Understøtter CI/CD og automatisering ved at parametrisere eksterne forbindelser til forskellige miljøer (udvikling, test, produktion).
  • Muliggør dynamisk konfiguration af eksterne relationer (for eksempel skift af datakilder eller legitimationsoplysninger pr. miljø).
  • Værdier vælges via en UI-dialog, ikke fri tekst, hvilket sikrer, at kun autoriserede forbindelser kan vælges.
  • Kun forbindelser med mindst læsetilladelser er tilgængelige for valg.

Repræsentation i Git og API'er

En Connection-reference er en avanceret variabeltype, hvis værdiskema gemmer connectionId (og platformen opløser/viser metadata). Forfatternyttelasten omfatter:

  • navn: displayNavnet på forbindelsesreferencevariablen
  • Bemærk: Valgfrit, kan bruges til beskrivelse eller andre noter.
  • type: "connectionReference" (avanceret type)
  • værdi: pr. værdisæt gemmer hver værdi { "connectionId": "<GUID/ID-streng>" }

Eksempel:


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

Tilladelser kræves for at oprette/bruge forbindelsesreferencer

Brug af forbindelsesreferencevariabler involverer to lag af tilladelser:

  • Opret og rediger en forbindelsesreferencevariabel: Brugere med Bidragyder eller højere roller i arbejdsområdet kan oprette og redigere variabler i biblioteket, mens Viewers er skrivebeskyttede.
  • Adgang til forbindelsesreferencevariablen: Ud over rettigheder på Variable Library skal du have mindst læsetilladelse til den forbindelsesreferencevariabel , du har til hensigt at referere til.

For mere information om tilladelser og tilladelsesvalidering, se Variable bibliotekstilladelser

Understøttede elementer

Følgende er en liste over elementer, der understøtter forbindelsesreferencevariabler:

Python-kodeeksempel

Følgende kodeeksempel viser, hvordan man bruger en forbindelsesreference i et python-script.

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

Denne kode gør følgende:

  • Løser en forbindelsesreferencevariabel fra et Fabric Variable-bibliotek
  • Henter forbindelsesmetadata-objektet
  • Udtrækker connectionId
  • Printer ID'et, så det kan bruges i kode- eller API-kald.

Begrænsninger

Følgende begrænsninger gælder for forbindelsesreferencevariabler:

  • Indbyggede forbindelser i Notebooks understøttes ikke, da connection_id for Notebook-forbindelsen ikke er den samme.

Relateret indhold

  • Last updated on