Share via


Globale parameters in Azure Data Factory

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

Globale parameters zijn constanten in een data factory die kan worden gebruikt door een pijplijn in elke expressie. Ze zijn handig wanneer u meerdere pijplijnen met identieke parameternamen en -waarden hebt. Bij het promoten van een data factory met behulp van het continue integratie- en implementatieproces (CI/CD), kunt u deze parameters in elke omgeving overschrijven.

Globale parameters maken

Als u een globale parameter wilt maken, gaat u naar het tabblad Globale parameters in de sectie Beheren . Selecteer Nieuw om het zijnavigatievenster voor het maken te openen.

Schermopname waarin de knop Nieuw is gemarkeerd die u selecteert om globale parameters te maken.

Voer in het zijnavigatievenster een naam in, selecteer een gegevenstype en geef de waarde van de parameter op.

Schermopname van waar u de naam, het gegevenstype en de waarde voor de nieuwe globale parameter toevoegt.

Nadat een globale parameter is gemaakt, kunt u deze bewerken door op de naam van de parameter te klikken. Als u meerdere parameters tegelijk wilt wijzigen, selecteert u Alles bewerken.

Globale parameters maken

Globale parameters gebruiken in een pijplijn

Globale parameters kunnen worden gebruikt in elke pijplijnexpressie. Als een pijplijn verwijst naar een andere resource, zoals een gegevensset of gegevensstroom, kunt u de globale parameterwaarde doorgeven via de parameters van die resource. Naar globale parameters wordt verwezen als pipeline().globalParameters.<parameterName>.

Globale parameters gebruiken

Globale parameters in CI/CD

We raden u aan om globale parameters op te slaan in de ARM-sjabloon tijdens de CI/CD. Het nieuwe mechanisme voor het opnemen van globale parameters in de ARM-sjabloon (van 'Hub beheren' -> 'ARM-sjabloon' -> 'Globale parameters opnemen in ARM-sjabloon ') zoals hieronder wordt geïllustreerd, zal de instellingen op fabrieksniveau niet conflicteren/ overschrijven zoals eerder is gebruikt, waardoor er geen extra PowerShell nodig is voor de implementatie van globale parameters tijdens CI/CD.

Schermopname van 'Opnemen in ARM-sjabloon'.

Notitie

We hebben de gebruikersinterface-ervaring voor het opnemen van globale parameters uit de sectie Globale parameters verplaatst naar de sectie ARM-sjabloon in de beheerhub. Als u al gebruikmaakt van het oudere mechanisme (vanuit 'Hub beheren' -> 'Globale parameters' -> 'Opnemen in ARM-sjabloon'),kunt u doorgaan. We blijven het ondersteunen.

Als u de oudere stroom voor het integreren van globale parameters in uw oplossing voor continue integratie en implementatie gebruikt, blijft deze werken:

  • Globale parameters opnemen in de ARM-sjabloon (vanuit 'Hub beheren' -> 'Globale parameters' -> 'Opnemen in ARM-sjabloon') Schermopname van afgeschafte 'Opnemen in ARM-sjabloon'.

  • Globale parameters implementeren via een PowerShell-script

We raden u ten zeerste aan het nieuwe mechanisme te gebruiken voor het opnemen van globale parameters in de ARM-sjabloon (van 'Hub beheren' -> 'ARM-sjabloon' -> 'Globale parameters opnemen in een ARM-sjabloon') omdat het CICD met globale parameters veel eenvoudiger en eenvoudiger te beheren maakt.

Notitie

De algemene parameters Opnemen in een ARM-sjabloonconfiguratie is alleen beschikbaar in de Git-modus. Deze is momenteel uitgeschakeld in de modus 'live' of 'Data Factory'.

Waarschuwing

U kunt '-' niet gebruiken in de parameternaam. U ontvangt een foutcode {"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' is ongeldig: .....}. Maar u kunt de '_' gebruiken in de parameternaam.

  • Meer informatie over het continue integratie- en implementatieproces van Azure Data Factory
  • Meer informatie over het gebruik van de expressietaal van de besturingsstroom