Share via

Gebruik Fabric-variabelebibliotheken in Dataflow Gen2 (voorproefversie)

Opmerking

Deze functie is momenteel beschikbaar als preview-versie en is alleen beschikbaar voor Dataflow Gen2 met CI/CD. Lees het artikel over CI/CD- en ALM-oplossingsarchitecturen voor dataflow Gen2 en de end-to-end-zelfstudie over variabele verwijzingen in een gegevensstroom voor meer informatie over het gebruik van deze mogelijkheid in continue integratie/continue implementatiescenario's (CI/CD).

Fabric-variabelebibliotheken bieden een gecentraliseerde manier om configuratiewaarden in Microsoft Fabric-workloads te beheren. Met de nieuwe integratie in Dataflow Gen2 (Preview) kunt u rechtstreeks in uw gegevensstroom verwijzen naar deze variabelen, waardoor dynamisch gedrag in verschillende omgevingen mogelijk is en CI/CD-werkstromen worden vereenvoudigd.

Vereiste voorwaarden

Als u Fabric variabele bibliotheken in Dataflow Gen2 wilt gebruiken, moet u het volgende controleren:

Fabric-variabele-bibliotheken gebruiken in Dataflow Gen2

In uw Dataflow Gen2 kunt u verwijzen naar een variabele met behulp van een van de volgende functies:

De verwachte id die moet worden doorgegeven aan een van deze twee functies, moet het volgende formaat hebben:

$(/**/LibraryName/VariableName)

De volgende voorbeelden voor beide functies in het scenario waarin u een variabelebibliotheek met de naam Mijn bibliotheek hebt en een variabele van het type tekenreeks met de naam Mijn variabele:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

Bij het toepassen van deze functie op een queryscript, laten we de volgende voorbeeldquery bekijken: deze maakt verbinding met een tabel genaamd Table1 van een specifieke LakehouseId en WorkspaceId, met gebruik van de Fabric Lakehouse-connector.

let
  Source = Lakehouse.Contents([]),
  #"Navigation 1" = Source{[workspaceId = "cfafbeb1-8037-4d0c-896e-a46fb27ff229"]}[Data],
  #"Navigation 2" = #"Navigation 1"{[lakehouseId = "5b218778-e7a5-4d73-8187-f10824047715"]}[Data],
  #"Navigation 3" = #"Navigation 2"{[Id = "Table1", ItemKind = "Table"]}[Data]
in
  #"Navigation 3"

U bent van plan de waarden te vervangen die zijn doorgegeven voor de workspaceIdlakehouseId CI/CD-scenario's, zodat deze dynamisch naar het juiste item in de juiste fase verwijst.

Hiervoor hebt u in dezelfde werkruimte waar uw gegevensstroom zich bevindt, ook een variabelebibliotheek met de naam Mijn bibliotheek die de volgende variabelen bevat waarnaar u in uw gegevensstroom wilt verwijzen:

Naam van de variabele Type variabele Standaardwaarde ingesteld
Werkruimte-id Snaar / Touwtje a8a1bffa-7eea-49dc-a1d2-6281c1d031f1
Lakehouse-ID Snaar / Touwtje 37dc8a41-dea9-465d-b528-3e95043b2356

Met deze informatie kunt u het queryscript wijzigen om de waarden te vervangen die resulteren in het volgende script:

let
  Source = Lakehouse.Contents([]),
  #"Navigation 1" = Source{[workspaceId = Variable.ValueOrDefault("$(/**/My Library/Workspace ID)",  "cfafbeb1-8037-4d0c-896e-a46fb27ff229")]}[Data],
  #"Navigation 2" = #"Navigation 1"{[lakehouseId =  Variable.ValueOrDefault("$(/**/My Library/Lakehouse ID)","5b218778-e7a5-4d73-8187-f10824047715")]}[Data],
  #"Navigation 3" = #"Navigation 2"{[Id = "Table1", ItemKind = "Table"]}[Data]
in
  #"Navigation 3"

Wanneer u de gegevensstroom uitvoert met het gewijzigde script, wordt deze omgezet in de waarde van de variabele en het juiste gegevenstype dat is gedefinieerd door de variabele. Dit verwijst naar een andere werkruimte en Lakehouse, afhankelijk van de waarden die beschikbaar zijn op het moment dat uw gegevensstroom wordt uitgevoerd.

Waarschuwing

De Power Query-editor biedt momenteel geen ondersteuning voor de evaluatie van variabelen. We raden u aan de functie Variable.ValueOrDefault te gebruiken om ervoor te zorgen dat uw ontwerpervaring gebruikmaakt van de standaardwaarde voor prototypen.

Wanneer u een standaardwaarde gebruikt via Variable.ValueOrDefault, zorgt u ervoor dat uw formule werkt, zelfs wanneer u uw oplossing kopieert of verplaatst naar een andere omgeving die de bibliotheek voor referentievariabelen niet bevat. Tijdens runtime wordt de variabele omgezet in de juiste waarde.

Overwegingen en beperkingen

De volgende lijst bevat belangrijke beperkingen en gedrag waarmee u rekening moet houden bij het gebruik van Fabric-variabelebibliotheken met Dataflow Gen2. Deze beperkingen zijn van invloed op de wijze waarop tijdens het ontwerpen en runtime naar variabelen wordt verwezen, geëvalueerd en toegepast.

  • Werkruimtebereik: variabelenbibliotheken moeten zich in dezelfde werkruimte bevinden als de Gegevensstroom Gen2 met CI/CD.

  • Referentielocatie: variabelen kunnen alleen worden gebruikt in het mashup.pq-bestand van een Dataflow Gen2 met CI/CD.

  • Runtimegedrag: variabelenwaarden worden opgehaald aan het begin van een uitvoeringsbewerking en blijven behouden tijdens de bewerking. Wijzigingen die plaatsvinden in een bibliotheek tijdens een gegevensstroomuitvoering, stoppen niet of beïnvloeden de uitvoering ervan niet.

  • Ondersteuning voor Power Query-editor: geen huidige ondersteuning voor het oplossen of evalueren van variabelen in de Power Query-editor.

  • Een standaardwaarde gebruiken: Wanneer u een standaardwaarde gebruikt via de functie Variable.ValueOrDefault, moet u ervoor zorgen dat het gegevenstype van de standaardwaarde overeenkomt met het gegevenstype van de variabele waarnaar wordt verwezen.

  • Ondersteunde typen: Alleen variabelen van basistypen worden ondersteund (boolean, datetime, guid, integer, numberen ).string

  • Vaste verbindingen: variabelen kunnen geen verbindingsgegevens wijzigen. Verbindingen blijven vast voor de configuraties van het ontwerpresourcepad.

  • Onderdrukkingsrisico: gebruikers met toegang tot het wijzigen van variabelenbibliotheken kunnen variabele waarden overschrijven, wat mogelijk van invloed is op de uitvoer van de gegevensstroom.

  • Schematoewijzing: variabelen kunnen de toewijzingen van het doelschema niet wijzigen; toewijzingen volgen de oorspronkelijke opstelling.

  • Zichtbaarheid van herkomst: herkomstweergaven tonen geen koppelingen tussen Dataflow Gen2 en de variabele bibliotheken waarnaar wordt verwezen.

  • Variabelelimiet: gegevensstromen kunnen maximaal 50 variabelen ophalen.

  • SPN-ondersteuning: gegevensstromen kunnen alleen worden vernieuwd als de vernieuwing geen SPN gebruikt voor verificatie.

  • Last updated on