Använda parametrar i en notebook-fil

Slutförd

Du kan använda parametrar för att skicka variabelvärden till en notebook-fil från pipelinen. Parameterisering ger större flexibilitet än att använda hårdkodade värden i notebook-koden.

Använda parametrar i en notebook-fil

Om du vill definiera och använda parametrar i en notebook-fil använder du biblioteket dbutils.widgets i din notebook-kod.

Följande Python-kod definierar till exempel en variabel med namnet mapp och tilldelar ett standardvärde för data:

dbutils.widgets.text("folder", "data")

Om du vill hämta ett parametervärde använder du funktionen get , så här:

folder = dbutils.widgets.get("folder")

Get-funktionen hämtar värdet för den specifika parameter som skickades till notebook-filen. Om ingen sådan parameter skickades får den standardvärdet för variabeln som du deklarerade tidigare.

Skicka utdatavärden

Förutom att använda parametrar som kan skickas till en notebook-fil kan du skicka ut värden till det anropande programmet med hjälp av funktionen notebook.exit, som du ser här:

path = "dbfs:/{0}/products.csv".format(folder)
dbutils.notebook.exit(path)

Ange parametervärden i en pipeline

Om du vill skicka parametervärden till en Notebook-aktivitet lägger du till varje parameter i aktivitetens basparametrar enligt följande:

Screenshot of a Notebook activity with a folder parameter.

I det här exemplet anges parametervärdet uttryckligen som en egenskap för notebook-aktiviteten . Du kan också definiera en pipelineparameter och tilldela dess värde dynamiskt till notebook-aktivitetens basparameter. Du kan lägga till ytterligare en abstraktionsnivå.

Dricks

Mer information om hur du använder parametrar i Azure Data Factory finns i Använda parametrar, uttryck och funktioner i Azure Data Factory i Azure Data Factory-dokumentationen.