Relatieve verwijzingen met Fabric-connectors in Dataflow Gen2

Opmerking

De inhoud van dit artikel is van toepassing op Dataflow Gen2 met CI/CD-ondersteuning.

Dataflow Gen2 is ontworpen ter ondersteuning van oplossingen die kunnen worden ontwikkeld, gevalideerd en geïmplementeerd in omgevingen zonder handmatige scriptwijzigingen. Ter ondersteuning van dit doel gebruiken Fabric-connectors in Dataflow Gen2 relatieve verwijzingen om werkruimteartefacten tijdens runtime op te lossen.

Met relatieve verwijzingen maken Dataflow-query's het mogelijk dat ze worden gekoppeld aan Fabric-items op basis van hun namen binnen de huidige werkruimte, in plaats van te vertrouwen op omgevingsspecifieke identificatoren, zoals werkruimte-id's of item-id's.

Fabric-connectors en werkruimtecontext

Fabric-connectors, zoals Lakehouse, Warehouse en SQL Database, bieden een navigatie-ervaring waarmee gebruikers kunnen bladeren en items kunnen selecteren waartoe ze toegang hebben. Wanneer een Dataflow Gen2 is gemaakt, wordt deze altijd uitgevoerd binnen de context van een specifieke werkruimte.

Relatieve verwijzingen profiteren van deze werkruimtecontext door artefactpaden op te lossen ten opzichte van de werkruimte waar de gegevensstroom zich bevindt.

In het navigatiedialoogvenster van de connector wordt deze context vertegenwoordigd door een !( Huidige werkruimte) knooppunt. Als u items onder dit knooppunt selecteert, wordt aangegeven dat de gegevensstroom deze items moet oplossen uit de werkruimte waarin deze wordt uitgevoerd.

Schermopname van de !(Huidige werkruimte) node in de Lakehouse-connector

Hoe relatieve verwijzingen worden weergegeven in query's

Wanneer een Fabric-connector relatieve verwijzingen gebruikt, bevat het gegenereerde Power Query-script (M) geen absolute id's zoals:

  • Werkruimte-id's
  • Lakehouse-ID's
  • Magazijn-ID's

In plaats daarvan verwijst het script naar artefacten op basis van de itemnamen, die uniek zijn binnen een werkruimte.

Als gevolg hiervan beschrijft de querylogica welk item moet worden geopend in plaats van waar dat item zich in een specifieke omgeving bevindt.

Gedrag in omgevingen

Omdat relatieve verwijzingen tijdens runtime worden opgelost met behulp van de huidige werkruimtecontext, kan dezelfde definitie van Dataflow Gen2 worden gebruikt in meerdere omgevingen, zoals:

  • Ontwikkeling
  • Test
  • Productie

Zolang de doelwerkruimte items met overeenkomende namen bevat, blijft de gegevensstroom werken zonder dat deze hoeft te worden gewijzigd. Er zijn geen wijzigingen in het Power Query-script vereist bij het implementeren via Fabric-implementatiepijplijnen.

Dit gedrag maakt relatieve verwijzingen geschikt voor enterprise ALM- en CI/CD-werkstromen.

Relatie met andere CI/CD-mogelijkheden

Relatieve verwijzingen vormen een aanvulling op bestaande dataflow Gen2-mogelijkheden die ondersteuning bieden voor omgevingsonafhankelijke oplossingen, waaronder:

Met deze functies kunnen Dataflow Gen2-oplossingen samen draagbaar, voorspelbaar en afgestemd op implementatiepijplijnpraktijken blijven.

Wanneer relatieve verwijzingen gebruiken

Relatieve verwijzingen zijn geschikt wanneer:

  • Een gegevensstroom wordt naar verwachting verplaatst naar meerdere werkruimten
  • Fabric-items (zoals Lakehouses of Warehouses) worden opnieuw gemaakt per omgeving
  • Wijzigingen op scriptniveau tijdens de implementatie moeten worden vermeden

Als een gegevensstroom moet zijn gericht op een specifiek artefact in een vaste werkruimte, kunnen absolute verwijzingen nog steeds worden gebruikt. De keuze is afhankelijk van de beoogde levenscyclus en het implementatiemodel van de oplossing.

Samenvatting

Relatieve verwijzingen bieden een manier voor Fabric-connectors in Dataflow Gen2 om werkruimteartefacten op te lossen op basis van context in plaats van vaste id's. Door te vertrouwen op itemnamen in de huidige werkruimte, kunnen gegevensstromen worden geïmplementeerd in omgevingen zonder scriptwijzigingen, waardoor consistente en onderhoudbare CI/CD-werkstromen worden ondersteund.