Openbare parameters gebruiken in Dataflow Gen2

Met parameters in Gegevensstroom Gen2 kunt u gegevensstromen dynamisch beheren en aanpassen, waardoor ze flexibeler en herbruikbaar worden door verschillende invoer en scenario's in te schakelen zonder de gegevensstroom zelf te wijzigen. Het helpt bij het organiseren van dingen door de noodzaak van meerdere gegevensstromen te verminderen en controle te centraliseren binnen één, geparameteriseerde gegevensstroom.

Openbare parameters in Dataflow Gen2 is een nieuwe modus waarin u kunt toestaan dat uw gegevensstroom wordt uitgevoerd door parameterwaarden buiten de Power Query-editor door te geven via de Fabric REST API of via systeemeigen Fabric-ervaringen. Hiermee kunt u een dynamischere ervaring hebben met uw gegevensstroom, waarbij elke uitvoering kan worden aangeroepen met verschillende parameters die van invloed zijn op de manier waarop uw gegevensstroom wordt uitgevoerd.

Vereiste voorwaarden

• Een Dataflow Gen2 met CI/CD-ondersteuning
• Parameters moeten worden ingesteld binnen uw gegevensstroom.Meer informatie over het instellen van queryparameters in de gegevensstroom.

De openbare parametermodus inschakelen

Open als eigenaar de gegevensstroom. Selecteer op het tabblad Start van het lint de knop Opties .

Als u de knop selecteert, wordt een nieuw dialoogvenster Opties geopend. Selecteer in het verticale menu de optie met het label Parameters in de gegevensstroomgroep . In de sectie Parameters kunt u de optie inschakelen "Parameters laten detecteren en overschrijven voor uitvoering" om de modus voor openbare parameters in te schakelen.

Selecteer de knop OK om deze wijzigingen door te voeren.

Wanneer deze modus is ingeschakeld, krijgt u een melding in het dialoogvenster Parameters beheren met de tekst 'Openbare parametermodus is ingeschakeld' boven aan het dialoogvenster.

Zodra de openbare parametermodus is ingeschakeld, kunt u de gegevensstroom opslaan.

Aangepaste parameterwaarden doorgeven voor gegevensstroomuitvoeringen

De modus openbare parameter volgt de definitie van de parameters in de gegevensstroom, waarbij er een onderscheid is tussen vereiste en niet-vereiste parameters.

• Vereiste parameters: als een parameter is ingesteld zoals vereist, moet een waarde worden doorgegeven aan de uitvoeringstaak om de gegevensstroom uit te voeren. De uitvoering mislukt als er geen waarde wordt doorgegeven voor een parameter die is ingesteld op vereist.
• Niet-vereiste parameters: deze worden ook wel optionele parameters genoemd en er hoeft geen waarde te worden doorgegeven om een uitvoering te activeren. Als er geen waarde wordt doorgegeven, wordt de huidige waarde die in uw parameter is gedefinieerd, gebruikt voor uitvoering.

De gegevensstroomactiviteit binnen pijplijnen gebruiken

Wanneer u een pijplijn in Fabric maakt, kunt u de gegevensstroomactiviteit gebruiken om de uitvoering van een Dataflow Gen2 te activeren met CI/CD-ondersteuning waarvoor de modus openbare parameters is ingeschakeld.

U kunt de gegevensstroom selecteren die u wilt gebruiken en de parameters instellen die u wilt gebruiken in de sectie Gegevensstroomparameters .

In de sectie Parameters voor gegevensstroom kunt u alle parameters zien die beschikbaar zijn in uw gegevensstroom en de standaardwaarde van elke parameter in de waardesectie.

Vereiste parameters hebben een sterretje naast hun naam, terwijl optionele parameters dat niet doen. Tegelijkertijd kunnen optionele parameters uit het raster worden verwijderd, terwijl vereiste parameters niet kunnen worden verwijderd en er een waarde moet worden doorgegeven om de gegevensstroom uit te voeren.

U kunt de knop Vernieuwen selecteren om de meest recente parametergegevens van uw gegevensstroom aan te vragen.

Ondersteunde parametertypen

In de volgende tabel ziet u de momenteel ondersteunde parametertypen en de koppeling naar de REST API-definitie om te begrijpen wat de waarden zijn die door de REST API worden verwacht.

Overwegingen en beperkingen

Hier volgt een lijst met alle overwegingen en beperkingen bij het gebruik van de modus openbare parameters in Dataflow Gen2 met CI/CD:

• Planning en handmatige triggering: gegevensstromen met openbare parameters kunnen niet worden gepland of handmatig worden geactiveerd via Fabric, tenzij er geen vereiste parameters zijn ingesteld.
• Niet-ondersteunde parameterisatie: parameters die resourcepaden voor bronnen of bestemmingen wijzigen, worden niet ondersteund. Verbindingen zijn bevestigd aan het vastgelegde pad.
• Incrementeel vernieuwen: niet compatibel met de modus openbare parameters.
• Logicawijziging: met openbare parameters kunnen gebruikers met toegang waarden overschrijven, waardoor de uitvoer van de gegevensstroom mogelijk wordt gewijzigd.
• Monitoring Hub: De Monitoring Hub geeft geen parameterwaarden weer die tijdens de uitvoering worden gebruikt.
• Faseringsgedrag: Alleen de meest recente run wordt opgeslagen in de Staging Lakehouse. Gebruik gedefinieerde bestemmingen om gegevens te bewaren.
• Dubbele aanvragen: als dezelfde parameterwaarden meerdere keren worden verzonden, wordt alleen de eerste aanvraag geaccepteerd totdat deze is voltooid.
• Schematoewijzing: Parameters kunnen doelschematoewijzingen niet wijzigen. Alle toewijzingen volgen de ontwerpconfiguratie. Raadpleeg het artikel voor meer informatie over gegevensbestemmingen en beheerde instellingen in Dataflow Gen2.