Globala parametrar i Azure Data Factory

  • Artikel

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Dricks

Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!

Globala parametrar är konstanter i en datafabrik som kan användas av en pipeline i valfritt uttryck. De är användbara när du har flera pipelines med identiska parameternamn och värden. När du marknadsför en datafabrik med hjälp av den kontinuerliga integrerings- och distributionsprocessen (CI/CD) kan du åsidosätta dessa parametrar i varje miljö.

Skapa globala parametrar

Om du vill skapa en global parameter går du till fliken Globala parametrar i avsnittet Hantera . Välj Ny för att öppna sidonavigering för skapande.

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

I sidonavigering anger du ett namn, väljer en datatyp och anger värdet för parametern.

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

När en global parameter har skapats kan du redigera den genom att klicka på parameterns namn. Om du vill ändra flera parametrar samtidigt väljer du Redigera alla.

Create global parameters

Använda globala parametrar i en pipeline

Globala parametrar kan användas i valfritt pipelineuttryck. Om en pipeline refererar till en annan resurs, till exempel en datamängd eller ett dataflöde, kan du skicka det globala parametervärdet via resursens parametrar. Globala parametrar refereras till som pipeline().globalParameters.<parameterName>.

Using global parameters

Globala parametrar i CI/CD

Vi rekommenderar att du inkluderar globala parametrar i ARM-mallen under CI/CD. Den nya mekanismen för att inkludera globala parametrar i ARM-mallen (från "Hantera hubb" –> "ARM-mall" –> "Inkludera globala parametrar i ARM-mallen ") enligt nedan, kommer inte att vara i konflikt med/åsidosätta inställningarna på fabriksnivå som det brukade göra tidigare, och därför krävs inte ytterligare PowerShell för distribution av globala parametrar under CI/CD.

Screenshot of 'Include in ARM template'.

Kommentar

Vi har flyttat användargränssnittsupplevelsen för att inkludera globala parametrar från avsnittet Globala parametrar till avsnittet "ARM-mall" i hanteringshubben. Om du redan använder den äldre mekanismen (från Hantera hubb –> globala parametrar –> Inkludera i ARM-mall) kan du fortsätta. Vi kommer att fortsätta att stödja det.

Om du använder det äldre flödet för att integrera globala parametrar i din lösning för kontinuerlig integrering och distribution fortsätter det att fungera:

  • Inkludera globala parametrar i ARM-mallen (från "Hantera hubb" –> Globala parametrar –> Inkludera i ARM-mall) Screenshot of deprecated 'Include in ARM template'.

  • Distribuera globala parametrar via ett PowerShell-skript

Vi rekommenderar starkt att du använder den nya mekanismen för att inkludera globala parametrar i ARM-mallen (från "Hantera hubb" –> "ARM-mall" –> "Inkludera globala parametrar i en ARM-mall") eftersom det gör CICD med globala parametrar mycket enklare och enklare att hantera.

Kommentar

Ta med globala parametrar i en ARM-mallkonfiguration är endast tillgängligt i "Git-läge". För närvarande är den inaktiverad i ”liveläge” och ”Data Factory-läge”.

Varning

Du kan inte använda "-" i parameternamnet. Du får felkoden "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=Uttrycket >'pipeline().globalParameters.myparam-dbtest-url' är inte giltigt: .....}". Men du kan använda '_' i parameternamnet.

Relaterat innehåll

  • Lär dig mer om Azure Data Factorys kontinuerliga integrerings - och distributionsprocess
  • Lär dig hur du använder kontrollflödesuttrycksspråket