Relativa referenser med Fabric-kopplingar i Dataflow Gen2

Anmärkning

Innehållet i den här artikeln gäller för Dataflow Gen2 med CI/CD-stöd.

Dataflöde Gen2 är utformat för att stödja lösningar som kan utvecklas, valideras och distribueras i miljöer utan manuella skriptändringar. För att stödja det här målet använder anslutningar i Fabric i Dataflow Gen2 relativa referenser för att lösa arbetsytefakter vid körning.

Relativa referenser gör att Dataflödesfrågor kan binda till Infrastrukturobjekt baserat på deras namn på den aktuella arbetsytan, i stället för att förlita sig på miljöspecifika identifierare, till exempel arbetsyte-ID:n eller objekt-ID:n.

Fabric-kontakter och arbetsmiljökontext

Infrastrukturanslutningar, till exempel Lakehouse, Warehouse och SQL Database, visar en navigeringsupplevelse som gör att användarna kan bläddra bland och välja objekt som de har åtkomst till. När en Dataflow Gen2 skapas körs den alltid inom ramen för en specifik arbetsyta.

Relativa referenser utnyttjar den här arbetsytekontexten genom att lösa artefaktsökvägar i förhållande till arbetsytan där Dataflow finns.

I navigeringsdialogrutan för anslutningsappen representeras den här kontexten av en !( Aktuell arbetsyta) nod. Att välja objekt under den här noden innebär att dataflödet ska lösa de objekten från arbetsytan där det körs.

Skärmbild av !(Aktuell arbetsyta) nod i Lakehouse-anslutningsappen

Hur relativa referenser representeras i frågor

När en Fabric-anslutningsapp använder relativa referenser innehåller det genererade Power Query-skriptet (M) inte absoluta identifierare, till exempel:

  • Arbetsyte-ID:t
  • Lakehouse-ID:er
  • Lager-ID

I stället refererar skriptet till artefakter efter deras objektnamn, som är unika i en arbetsyta.

Därför beskriver frågelogik vilket objekt som ska kommas åt i stället för var objektet finns i en specifik miljö.

Beteende i olika miljöer

Eftersom relativa referenser löses vid körning med den aktuella arbetsytekontexten kan samma Dataflow Gen2-definition användas i flera miljöer, som till exempel:

  • Utveckling
  • Testa
  • Produktion

Så länge målarbetsytan innehåller objekt med matchande namn fortsätter Dataflödet att fungera utan ändringar. Inga ändringar i Power Query-skriptet krävs när du distribuerar via Fabric-distributionspipelines.

Det här beteendet gör relativa referenser lämpliga för enterprise ALM- och CI/CD-arbetsflöden.

Relation till andra CI/CD-funktioner

Relativa referenser kompletterar befintliga Dataflow Gen2-funktioner som stöder miljöoberoende lösningar, inklusive:

Tillsammans gör dessa funktioner det möjligt för Dataflow Gen2-lösningar att förbli portabla, förutsägbara och anpassade till distributionspipelinemetoder.

När du ska använda relativa referenser

Relativa referenser är lämpliga när:

  • Ett dataflöde förväntas flyttas över flera arbetsytor
  • Infrastrukturobjekt (till exempel Lakehouses eller Warehouses) återskapas per miljö
  • Ändringar på skriptnivå under distributionen bör undvikas

Om ett dataflöde måste riktas mot en specifik artefakt på en fast arbetsyta kan absoluta referenser fortfarande användas. Valet beror på lösningens avsedda livscykel och distributionsmodell.

Sammanfattning

Relativa referenser är ett sätt för Fabric-kopplingar i Dataflow Gen2 att hantera arbetsyteobjekt baserat på kontext istället för fasta identifierare. Genom att förlita sig på objektnamn i den aktuella arbetsytan kan dataflöden distribueras i miljöer utan skriptändringar, vilket stöder konsekventa och underhållsbara CI/CD-arbetsflöden.