Använda parametrar i en anteckningsbok

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 dbutils.widgets-biblioteket 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 hämta, så här:

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

Funktionen hämta 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 i till en notebook-fil kan du skicka värden ut 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:

Skärmbild av en notebook-aktivitet med en mappparameter.

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

Tips

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.