Jaa

Yhteysreferenssimuuttujan tyyppi (esikatselu)

Yhteysviitemuuttuja on työtilan muuttuja, joka tallentaa ulkoisen datayhteyden ID:n (esim. Snowflake, Azure SQL), jolloin alkioiden voi viitata ulkoisiin resursseihin ilman tunnistetietojen tai yhteysmerkkijonojen upottamista.

Käyttäminen

Yhteysreferenssimuuttujaa voidaan käyttää kuten muita muuttujakirjaston muuttujia.

  1. Kirjaudu Microsoft Fabric -palveluun
  2. Siirry työtilaasi ja muuttujakirjastoon
  3. Ylhäällä valitse + Uusi muuttuja
  4. Anna muuttujalle nimi, valitse yhteysviite tyypille ja klikkaa sitten ... valitaksesi arvon

Kuvakaappaus saatavilla olevista esineistä yhteysviittausta varten. 5. Kun yhteysviite on valittu, sen pitäisi olla käyttökelpoinen.

Kuvakaappaus yhteysviittauksesta.

Jos sinun täytyy muokata yhteysviitettä tai tarkistaa arvo, voit hiiren oikealla painikkeella avata ponnahdusikkunan, jossa on tietoa yhteysviittauksesta.

Kuvakaappaus yhteysviittauksen ponnahdusikkunasta.

Näin se toimii

Yhteysreferenssimuuttujan arvo on staattinen osoitin yhteysobjektiin, joka tunnistetaan sen yhteystunnuksella. Arvo tallennetaan merkkijonona, joka vastaa kohdeyhteyden ID:tä. Esimerkkejä:

ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Tämä tunniste tunnistaa viitatun yhteyden yksikäsitteisesti. Staattinen viite ei mukautu automaattisesti eri käyttöönottoympäristöihin. Se vaatii, että kohdeyhteys on olemassa valintahetkellä ja pysyy osoitettuna kyseiseen yhteyteen, ellei sitä muuteta manuaalisesti.

Pidä mielessä seuraavat asiat, kun työskentelet yhteysviittausten kanssa:

  • Tallentaa ennalta määritellyn yhteystunnisteen vuokralaistasolla.
  • Yhteysviittaukset eivät sitoudu automaattisesti käyttöönoton aikana. Niiden arvot pysyvät kiinteinä eri ympäristöissä.
  • Tukee CI/CD:tä ja automaatiota parametrisoimalla ulkoiset yhteydet eri ympäristöille (kehitys, testi, tuotanto).
  • Mahdollistaa ulkoisten suhteiden dynaamisen konfiguroinnin (esimerkiksi tietolähteiden tai tunnistetietojen vaihtaminen ympäristön mukaan).
  • Arvot valitaan käyttöliittymän kautta, ei vapaan tekstin kautta, joten valittavissa on vain valtuutetut yhteydet.
  • Valittavissa ovat vain yhteydet, joilla on vähintään lukuoikeudet.

Esitys Gitissä ja API:ssa

Yhteysviittaus on kehittynyt muuttujatyyppi, jonka arvoskeema tallentaa connectionId:n (ja alusta ratkaisee/näyttää metatiedot). Tekijän hyötykuorma sisältää:

  • nimi: näyttö Yhteysviitemuuttujan nimi
  • Huomautus: Valinnainen, voidaan käyttää kuvaukseen tai muihin muistiinpanoihin.
  • type: "connectionReference" (edistynyt tyyppi)
  • arvo: per arvojoukko tallentaa { "connectionId": "<GUID/ID-merkkijono>" }

Esimerkki:


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

Yhteysviittausten luomiseen tai käyttöön vaaditut oikeudet

Yhteysviitemuuttujien käyttö sisältää kaksi käyttöoikeuskerrosta:

  • Luo ja muokkaa yhteysviitemuuttujaa: Työntekijät, joilla on Contributor tai sitä korkeammat roolit työtilassa, voivat luoda ja muokata muuttujia kirjastossa, kun taas Viewerit ovat vain luku -tilassa.
  • Yhteysviitemuuttujan käyttö: Muuttujakirjaston oikeuksien lisäksi sinulla täytyy olla vähintään lukuoikeus siihen yhteysviitemuuttujaan , johon aiot viitata viitattaviksi.

Lisätietoja käyttöoikeuksista ja käyttöoikeuksien validoinnista löytyy kohdasta Muuttujakirjaston käyttöoikeudet

Tuetut kohteet

Seuraavassa on luettelo kohteista, jotka tukevat yhteysviitemuuttujia:

Python-koodiesimerkki

Seuraava koodiesimerkki näyttää, miten yhteysviittausta käytetään python-skriptissä.

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

Koodilla voidaan suorittaa seuraavia toimintoja:

  • Ratkaisee Connection Reference -muuttujan Fabric-muuttujakirjastosta
  • Hae yhteyden metatietoobjektin
  • Poimee connectionId:n
  • Tulostaa ID:n, jotta sitä voidaan käyttää koodissa tai API-kutsuissa.

Rajoitukset

Seuraavat rajoitukset koskevat yhteysviitemuuttujia:

  • Notebookien sisäänrakennetut yhteydet eivät ole tuettuja, koska Notebook-yhteyden connection_id ei ole sama.

Liittyvä sisältö

  • Last updated on