Relative referanser med Fabric-koblinger i Dataflow Gen2

Bemerkning

Innholdet i denne artikkelen gjelder for Dataflow Gen2 med CI/CD-støtte.

Dataflow Gen2 er designet for å støtte løsninger som kan utvikles, valideres og distribueres på tvers av miljøer uten manuelle skriptendringer. For å støtte dette målet bruker Fabric-koblinger i Dataflow Gen2 relative referanser for å løse arbeidsområdeartefakter under kjøring.

Relative referanser gjør det mulig for Dataflow-spørringer å binde seg til Fabric-elementer basert på navnene deres i det nåværende arbeidsområdet, i stedet for å være avhengige av miljøspesifikke identifikatorer som arbeidsområde-IDer eller vare-IDer.

Fabric-kontakter og arbeidsområdekontekst

Fabric-koblinger, som Lakehouse, Warehouse og SQL Database, gir en navigasjonsopplevelse som lar brukere bla gjennom og velge elementer de har tilgang til. Når en Dataflow Gen2 er opprettet, kjører den alltid innenfor konteksten av et spesifikt arbeidsområde.

Relative referanser utnytter denne arbeidsområdets kontekst ved å løse artefaktstier relativt til arbeidsområdet der Dataflowen befinner seg.

I koblingsnavigasjonsdialogen representeres denne konteksten av en !( Nåværende arbeidsområde) node. Å velge elementer under denne noden indikerer at Dataflowen skal løse disse elementene fra arbeidsområdet der den kjøres.

Skjermbilde av ! (Nåværende arbeidsområde) node i Lakehouse-kontakten

Hvordan relative referanser representeres i spørringer

Når en Fabric-kobling bruker relative referanser, inkluderer ikke det genererte Power Query (M)-skriptet absolutte identifikatorer som:

  • Arbeidsområde-IDer
  • Lakehouse-ID-er
  • Lager-ID-er

I stedet refererer skriptet til artefakter via deres objektnavn, som er unike innenfor et arbeidsområde.

Som et resultat beskriver spørringslogikken hvilket element som skal åpnes, i stedet for hvor det elementet befinner seg i et spesifikt miljø.

Atferd på tvers av miljøer

Fordi relative referanser løses under kjøring ved bruk av nåværende arbeidsområdekontekst, kan den samme Dataflow Gen2-definisjonen brukes på tvers av flere miljøer, slik som:

  • Utvikling
  • Test
  • Produksjon

Så lenge målarbeidsområdet inneholder elementer med matchende navn, fortsetter Dataflowen å fungere uten endringer. Ingen endringer i Power Query-skriptet kreves ved distribusjon gjennom Fabric-distribusjonspipelines.

Denne oppførselen gjør relative referanser egnet for enterprise ALM og CI/CD-arbeidsflyter.

Forhold til andre CI/CD-kapabiliteter

Relative referanser utfyller eksisterende Dataflow Gen2-funksjoner som støtter miljøuavhengige løsninger, inkludert:

Sammen gjør disse funksjonene det mulig for Dataflow Gen2-løsninger å forbli portable, forutsigbare og i tråd med implementeringspipeline-praksis.

Når man skal bruke relative referanser

Relative referanser er passende når:

  • En dataflyt forventes å bevege seg på tvers av flere arbeidsområder
  • Tekstilgjenstander (som innsjøhus eller lagerbygninger) gjenskapes i hvert miljø
  • Endringer på skriptnivå under utrulling bør unngås

Hvis en Dataflow må rette seg mot en spesifikk artefakt i et fast arbeidsområde, kan absolutte referanser fortsatt brukes. Valget avhenger av den tiltenkte livssyklusen og distribusjonsmodellen for løsningen.

Sammendrag

Relative referanser gir en måte for Fabric-koblinger i Dataflow Gen2 å løse arbeidsområdeartefakter basert på kontekst i stedet for faste identifikatorer. Ved å stole på varenavn i det nåværende arbeidsområdet, kan Dataflows distribueres på tvers av miljøer uten skriptendringer, og støtter konsistente og vedlikeholdbare CI/CD-arbeidsflyter.