Parameters gebruiken in een notebook
U kunt parameters gebruiken om variabele waarden door te geven aan een notebook vanuit de pijplijn. Parameterisatie maakt meer flexibiliteit mogelijk dan het gebruik van in code vastgelegde waarden in de notebookcode.
Parameters gebruiken in een notebook
Als u parameters in een notebook wilt definiëren en gebruiken, gebruikt u de bibliotheek dbutils.widgets in uw notebookcode.
Met de volgende Python-code wordt bijvoorbeeld een variabele met de naam van een map gedefinieerd en wordt een standaardwaarde van gegevens toegewezen:
dbutils.widgets.text("folder", "data")
Als u een parameterwaarde wilt ophalen, gebruikt u de functie Get , zoals deze:
folder = dbutils.widgets.get("folder")
De get-functie haalt de waarde op voor de specifieke parameter die is doorgegeven aan het notebook. Als er geen dergelijke parameter is doorgegeven, krijgt deze de standaardwaarde van de variabele die u eerder hebt gedeclareerd.
Uitvoerwaarden doorgeven
Naast het gebruik van parameters die kunnen worden doorgegeven aan een notebook, kunt u waarden doorgeven aan de aanroepende toepassing met behulp van de functie notebook.exit, zoals hier wordt weergegeven:
path = "dbfs:/{0}/products.csv".format(folder)
dbutils.notebook.exit(path)
Parameterwaarden instellen in een pijplijn
Als u parameterwaarden wilt doorgeven aan een Notebook-activiteit, voegt u elke parameter toe aan de basisparameters van de activiteit, zoals hier wordt weergegeven:
In dit voorbeeld wordt de parameterwaarde expliciet opgegeven als een eigenschap van de Notebook-activiteit . U kunt ook een pijplijnparameter definiëren en de bijbehorende waarde dynamisch toewijzen aan de basisparameter van de Notebook-activiteit . Daarnaast kunt u een extra abstractieniveau toevoegen.
Tip
Zie Parameters, expressies en functies gebruiken in Azure Data Factory in de documentatie van Azure Data Factory voor meer informatie over het gebruik van parameters in Azure Data Factory.