Dela via


Globala parametrar i Azure Data Factory

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.

Skärmbild som visar knappen Nytt som du väljer för att skapa globala parametrar.

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

Skärmbild som visar var du lägger till namn, datatyp och värde för den nya globala parametern.

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.

Skapa globala parametrar

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

Använda globala parametrar

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.

Skärmbild av

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) Skärmbild av inaktuell

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

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