Delen via

Type verbindingsverwijzingsvariabele (preview)

Een verbindingsverwijzingsvariabele is een werkruimtevariabele waarin de id van een externe gegevensverbinding (bijvoorbeeld Snowflake, Azure SQL) wordt opgeslagen, zodat items naar externe resources kunnen verwijzen zonder referenties of verbindingsreeksen in te sluiten.

Hoe te gebruiken

Een verbindingsreferentievariabele kan net als andere variabelen in een variabelebibliotheek worden gebruikt.

  1. Aanmelden bij Microsoft Fabric
  2. Navigeer naar uw werkruimte en variabele bibliotheek
  3. Selecteer bovenaan + Nieuwe variabele
  4. Geef een naam op voor de variabele, selecteer de verbindingsreferentie voor het type en klik vervolgens op de ... om een waarde te selecteren

Schermopname van de items die beschikbaar zijn voor de verbindingsreferentie. 5. Zodra deze is geselecteerd, moet uw verbindingsreferentie gereed zijn voor gebruik.

Schermopname van de verbindingsreferentie.

Als u een verbindingsverwijzing wilt bewerken of de waarde wilt controleren, kunt u met de rechtermuisknop op de waarde klikken om een pop-upvenster weer te geven met informatie over de verbindingsverwijzing.

Schermopname van het pop-upvenster voor verbindingsverwijzingen.

Hoe werkt het?

De waarde van een verbindingsverwijzingsvariabele is een statische aanwijzer naar een verbindingsobject dat wordt geïdentificeerd door de bijbehorende verbindings-id. De waarde wordt opgeslagen als een tekenreeks die overeenkomt met de id van de doelverbinding. Voorbeeld:

ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbbbb

Met deze id wordt de verbinding waarnaar wordt verwezen, uniek geïdentificeerd. De statische verwijzing wordt niet automatisch aangepast aan verschillende implementatieomgevingen. Het vereist dat de doelverbinding bestaat op het moment van selectie en blijft naar die specifieke verbinding wijzen, tenzij handmatig gewijzigd.

Houd rekening met het volgende bij het werken met verbindingsverwijzingen:

  • Slaat een vooraf gedefinieerde verbindings-id op tenantniveau op.
  • Verbindingsverwijzingen worden niet automatisch verbonden tijdens de implementatie. Hun waarden blijven vast in omgevingen.
  • Ondersteunt CI/CD en automatisering door externe verbindingen voor verschillende omgevingen te parameteriseren (dev, test, prod).
  • Maakt dynamische configuratie van externe relaties mogelijk (bijvoorbeeld het schakelen tussen gegevensbronnen of referenties per omgeving).
  • Waarden worden gekozen via een gebruikersinterfacedialoogvenster, geen vrije tekst, zodat alleen geautoriseerde verbindingen kunnen worden geselecteerd.
  • Alleen verbindingen met ten minste leesmachtigingen zijn beschikbaar voor selectie.

Weergave in Git en API’s

Een verbindingsverwijzing is een geavanceerd variabeletype waarvan het waardeschema de connectionId opslaat (en het platform lost metagegevens op/weer). De creatiepayload bevat:

  • name: de displayName van de verbindingsreferentievariabele
  • opmerking: optioneel, kan worden gebruikt voor beschrijving of andere notities.
  • type: "connectionReference" (geavanceerd type)
  • waarde: per waarde‑set, elke waarde slaat { "connectionId": "<GUID/ID string>" } op

Voorbeeld:


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

Vereiste machtigingen voor het maken/gebruiken van verbindingsverwijzingen

Het gebruik van verbindingsreferentievariabelen omvat twee lagen machtigingen:

  • Een verbindingsverwijzingsvariabele maken en bewerken: Gebruikers met de rol van bijdrager of hoger in de werkruimte kunnen variabelen maken en bewerken in de bibliotheek, terwijl kijkers alleen-lezen toegang hebben.
  • Toegang tot de verbindingsverwijzingsvariabele: naast rechten voor de variabelebibliotheek moet u minimaal leesmachtigingen hebben voor de verbindingsverwijzingsvariabele waarnaar u wilt verwijzen.

Voor meer informatie over machtigingen en machtigingsvalidatie, zie machtigingen van de variabelenbibliotheek.

Ondersteunde items

Hier volgt een lijst met items die ondersteuning bieden voor verbindingsreferentievariabelen:

Voorbeeld van Python-code

In het volgende codevoorbeeld ziet u hoe u een verbindingsreferentie gebruikt in een Python-script.

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

Deze code doet het volgende:

  • Lost een verbindingsreferentievariabele op uit een Fabric-variabelenbibliotheek
  • Hiermee wordt het metagegevensobject van de verbinding opgehaald
  • Extraheert de connection-ID
  • Hiermee wordt de id afgedrukt zodat deze kan worden gebruikt in code- of API-aanroepen.

Beperkingen

De volgende beperkingen gelden voor verbindingsreferentievariabelen:

  • Ingebouwde verbindingen in notebooks worden niet ondersteund omdat de connection_id voor de notebookverbinding niet hetzelfde is.

Verwante inhoud

  • Last updated on