Verwenden von Parametern in einem Notebook

Abgeschlossen

Sie können Parameter verwenden, um Variablenwerte aus der Pipeline an ein Notebook zu übergeben. Die Parametrisierung bietet mehr Flexibilität als die Verwendung hartcodierter Werte im Notebookcode.

Verwenden von Parametern in einem Notebook

Zum Definieren und Verwenden von Parametern in einem Notebook verwenden Sie die Bibliothek dbutils.widgets in Ihrem Notebookcode.

Ein Beispiel: Der folgende Python-Code definiert eine Variable namens folder und weist den Standardwert data zu:

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

Um einen Parameterwert abzurufen, verwenden Sie die get-Funktion, wie hier gezeigt:

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

Die get-Funktion ruft den Wert für den Parameter ab, der an das Notebook übergeben wurde. Wenn kein solcher Parameter übergeben wurde, wird der Standardwert der zuvor deklarierten Variablen abgerufen.

Übergeben von Ausgabewerten

Zusätzlich zu Parameter, die an ein Notebook übergeben werden, können Sie Werte aus der aufrufenden Anwendung übergeben, indem Sie die Funktion notebook.exit verwenden, wie hier gezeigt:

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

Festlegen von Parameterwerten in einer Pipeline

Um Parameterwerte an eine Notebookaktivität zu übergeben, fügen Sie jeden Parameter zu den Basisparametern der Aktivität hinzu, wie hier gezeigt:

Screenshot of a Notebook activity with a folder parameter.

In diesem Beispiel wurde der Parameterwert explizit als Eigenschaft der Notebookaktivität angegeben. Sie können auch einen Pipelineparameter definieren und dessen Wert dynamisch dem Basisparameter der Notebookaktivität zuweisen. Dadurch entsteht eine weitere Abstraktionsebene.

Tipp

Weitere Informationen zur Verwendung von Parametern in Azure Data Factory finden Sie unter Verwenden von Parametern, Ausdrücken und Funktionen in Azure Data Factory in der Dokumentation zu Azure Data Factory.