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

Screenshot that highlights the New button you select to create global parameters.

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

Screenshot that shows where you add the name, data type, and value for the new global parameter.

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.

Create global parameters

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

Using global parameters

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.

Screenshot of 'Include in ARM template'.

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') Screenshot of deprecated 'Include in ARM template'.

  • 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 niet geldig: .....}". 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