Fabric-variabelenbibliotheken gebruiken in Dataflow Gen2

Opmerking

Lees voor meer informatie over het gebruik van deze mogelijkheid in CI/CD-scenario's (continue integratie/continue implementatie) het artikel over CI/CD- en ALM-oplossingsarchitecturen voor Dataflow Gen2 en de end-to-end-zelfstudie over variabele verwijzingen in een gegevensstroom.

Fabric-variabelebibliotheken bieden een gecentraliseerde manier om configuratiewaarden in Microsoft Fabric-workloads te beheren. Met de nieuwe integratie in Dataflow Gen2 kunt u rechtstreeks naar deze variabelen verwijzen in uw gegevensstroom, 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:

Referentievariabelen met invoerwidgets

Dialoogvensters voor gegevensstroom Gen2 bevatten een invoerwidget waarmee u kunt kiezen hoe u een veldwaarde invoert. In ondersteunde dialoogvensters kunt u variabelen selecteren met behulp van deze widget.

Schermopname van de invoerwidget in een dialoogvenster met filterrijen met de meerdere opties die beschikbaar zijn voor invoer.

Opmerking

Als u de invoerwidget wilt gebruiken, selecteert u op het tabblad Weergave op het lint in de groep Parameters de optie Altijd toestaan. Schermopname van het selectievakje Altijd toestaan op het tabblad Weergave van het lint om de invoerwidget in te schakelen.

Sommige dialoogvensters ondersteunen de ervaring van de invoerwidget en Fabric-variabelebibliotheken, waaronder:

Wanneer u de variabeleoptie in de invoerwidget selecteert, wordt het dialoogvenster variabelekiezer weergegeven. In dit dialoogvenster kunt u bladeren door uw bibliotheken van variabelen en de variabelen die ze bevatten.

Schermopname van het dialoogvenster Variabele selecteren waarin alle beschikbare bibliotheken en variabelen in de huidige werkruimte worden weergegeven.

Nadat u een variabele hebt geselecteerd, worden in het dialoogvenster de naam van de bibliotheek en de variabele weergegeven, zodat u uw selectie kunt bevestigen voordat u deze doorvoert.

Schermopname van een variabele met de naam Plafond uit de bibliotheek 'My library', weergegeven als geselecteerd in het dialoogvenster Filterrijen.

Opmerking

Niet alle gegevensstroomervaringen ondersteunen de invoerwidget. Gebruik de variabelefuncties handmatig voor niet-ondersteunde ervaringen of aangepaste scenario's.

Variabele functies

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

De id die u aan een van beide functies doorgeeft, moet de volgende indeling gebruiken:

$(/**/LibraryName/VariableName)

In de volgende voorbeelden wordt uitgegaan van een variabelebibliotheek met de naam Mijn bibliotheek en een tekenreeksvariabele met de naam Mijn variabele:

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

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

Door een standaardwaarde te gebruiken via Variable.ValueOrDefault, zorgt u ervoor dat uw formule wordt opgelost, zelfs wanneer u uw oplossing kopieert of verplaatst naar een andere omgeving die niet beschikt over de referentiebibliotheek.

Aanbeveling

Sla elke variabele op als een afzonderlijke query waarvoor geen fasering is vereist. Met deze methode kunt u deze waarden gebruiken in dialoogvensters die ondersteuning bieden voor de queryinvoer en kunt u een georganiseerde weergave van variabelen in uw gegevensstroom behouden.

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: variabele waarden worden opgehaald aan het begin van een uitvoeringsbewerking en blijven behouden tijdens de bewerking. Wijzigingen in een bibliotheek tijdens een gegevensstroomuitvoering stoppen niet of hebben geen invloed op die uitvoering.

  • 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.

  • Last updated on