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 du kan använda parametrar som skickas in till en anteckningsbok, kan du också skicka värden ut till det anropande programmet genom att använda funktionen notebook.exit, som visas 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.