Paraméterek használata jegyzetfüzetben

Befejeződött

Paraméterekkel változó értékeket adhat át egy jegyzetfüzetnek a folyamatból. A paraméterezés nagyobb rugalmasságot tesz lehetővé, mint a jegyzetfüzet kódjában lévő, rögzített értékek használata.

Paraméterek használata jegyzetfüzetben

Ha paramétereket szeretne definiálni és használni egy jegyzetfüzetben, használja a dbutils.widgets könyvtárat a jegyzetfüzet kódjában.

A következő Python-kód például egy változó nevű mappát határoz meg, és egy alapértelmezett adatértéket rendel hozzá:

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

Paraméterérték lekéréséhez használja a get függvényt a következő módon:

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

A get függvény lekéri a jegyzetfüzetnek átadott adott paraméter értékét. Ha nem ad át ilyen paramétert, az a korábban deklarált változó alapértelmezett értékét fogja megkapni.

Kimeneti értékek átadása

A jegyzetfüzetbe továbbítható paraméterek használata mellett az értékeketa notebook.exit függvény használatával is átadhatja a hívó alkalmazásnak, ahogy az itt látható:

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

Paraméterértékek beállítása folyamatban

Ha paraméterértékeket szeretne átadni egy jegyzetfüzet-tevékenységnek , adja hozzá az egyes paramétereket a tevékenység alapparamétereihez, az itt látható módon:

Screenshot of a Notebook activity with a folder parameter.

Ebben a példában a paraméter értéke explicit módon van megadva a Notebook-tevékenység tulajdonságaként. Definiálhat egy folyamatparamétert is, és dinamikusan rendelheti hozzá az értékét a Jegyzetfüzet-tevékenység alapparaméteréhez; további absztrakciós szintet adhat hozzá.

Tipp.

A paraméterek Azure Data Factoryben való használatáról az Azure Data Factory dokumentációjában talál további információt: Paraméterek, kifejezések és függvények használata az Azure Data Factoryben .