Usare parametri in un notebook
È possibile usare i parametri per passare valori di variabile a un notebook dalla pipeline. La parametrizzazione consente una maggiore flessibilità rispetto all'uso di valori hardcoded nel codice del notebook.
Usare parametri in un notebook
Per definire e usare i parametri in un notebook, usare la libreria dbutils.widgets nel codice del notebook.
Ad esempio, il codice Python seguente definisce una variabile denominata folder e assegna un valore predefinito di dati:
dbutils.widgets.text("folder", "data")
Per recuperare un valore di parametro, usare la funzione get, come illustrato di seguito:
folder = dbutils.widgets.get("folder")
La funzione get recupererà il valore per il parametro specifico passato al notebook. Se non è stato passato alcun parametro di questo tipo, otterrà il valore predefinito della variabile dichiarata in precedenza.
Passaggio di valori di output
Oltre a usare i parametri che possono essere passati a un notebook, è possibile passare i valori all'applicazione chiamante usando la funzione notebook.exit, come illustrato di seguito:
path = "dbfs:/{0}/products.csv".format(folder)
dbutils.notebook.exit(path)
Impostazione dei valori dei parametri in una pipeline
Per passare i valori dei parametri a un'attività Notebook, aggiungere ogni parametro ai parametri base dell'attività, come illustrato di seguito:
In questo esempio, il valore del parametro viene specificato in modo esplicito come proprietà dell'attività Notebook. È anche possibile definire un parametro della pipeline e assegnarne il valore in modo dinamico al parametro di base dell'attività Notebook, aggiungendo un ulteriore livello di astrazione.
Suggerimento
Per altre informazioni sull'uso dei parametri in Azure Data Factory, vedere Come usare parametri, espressioni e funzioni in Azure Data Factory nella documentazione di Azure Data Factory.