Feladat paramétereinek konfigurálása
Ez a cikk a feladatparaméterek funkcióit és a feladatparaméterek konfigurálását ismerteti a Databricks-munkaterület felhasználói felületén. Feladatparamétereket is hozzáadhat a REST API-val, parancssori felülettel és DAB-kkal használt JSON- és YAML-definíciókhoz. Lásd: Jobs API, Mi a Databricks parancssori felület?, és mik azok a Databricks-eszközcsomagok?.
Mik azok a feladatparaméterek?
A feladatparaméterek kulcs-érték párok, amelyek lehetővé teszik a feladatok paraméterezését alapértelmezett statikus vagy dinamikus értékekkel. Új futtatás indításakor igény szerint felülbírálhatja a feladatban konfigurált paramétereket. Lásd: Feladat futtatása különböző paraméterekkel.
A feladatparaméter-kulcsok csak karaktereket vagy alfanumerikus karaktereket tartalmazhatnak _ - . . A paraméterértékek sztringként vagy dinamikus értékhivatkozásként vannak beállítva. Lásd : Mi az a dinamikus értékhivatkozás?.
Feljegyzés
Bármely érvényes JSON paraméterértékként használható. A feladattípus például For each elemezheti az alábbi listákat:
[1, 2, 3]
['a', 'b', 'c']
Feladatparaméterek hozzáadása vagy szerkesztése
A Feladatparaméterek párbeszédpanelen új paramétereket adhat hozzá, szerkesztheti a meglévő paraméterkulcsokat és értékeket, vagy törölheti a paramétereket.
Ha a munkaterület felhasználói felületével szeretné szerkeszteni a paramétereket, válasszon ki egy meglévő feladatot az alábbi lépések végrehajtásával:
- Kattintson
a Munkafolyamatok elemre az oldalsávon. - A Név oszlopban kattintson a feladat nevére.
- A Feladat részletei oldalsávon kattintson a Paraméterek szerkesztése elemre. Megjelenik a Feladatparaméterek párbeszédpanel.
- Paraméterek hozzáadása és szerkesztése Kulcs és Érték mezők használatával.
- Kattintson a
paraméter eltávolításához. - A módosítások alkalmazásához kattintson a Mentés gombra.
Feljegyzés
Kattintson a { } gombra az elérhető dinamikus értékhivatkozások listázásához. Válasszon egy lehetőséget a listából, és szúrja be az Érték mezőbe.
Feladatparaméter leküldése
A feladatparaméterek automatikusan le lesznek küldve kulcs-érték paraméterként az összes olyan tevékenységhez, amely elfogadja a kulcs-érték paramétereket, amelyek a következő feladattípusokat tartalmazzák:
- Jegyzetfüzet
- Python-kerék (csak akkor, ha kulcsszóargumentumokkal van konfigurálva)
- SQL-lekérdezés, örökölt irányítópult vagy fájl
- Feladat futtatása
A tevékenységeknek átadott feladatparaméterek a felhasználói felületen lévő feladatkonfigurációban a konfigurált tevékenységparaméterek mellett láthatók.
Fontos
A feladatparaméterek elsőbbséget élveznek a tevékenységparaméterekkel szemben. Ha egy feladatparaméter és egy tevékenységparaméter ugyanazzal a kulccsal rendelkezik, a feladatparaméter felülbírálja a tevékenységparamétert.
Dinamikus értékhivatkozások feladatparaméterekre
A dinamikus értékhivatkozásokat elfogadó összes tevékenység hozzáférhet a feladatparaméterekhez.
Használja a dinamikus értékhivatkozást {{job.parameters.<name>}}, és cserélje le <name> a key paramétert azonosítóra.
Feladat futtatása különböző paraméterekkel
Felülbírálhatja a konfigurált feladatparamétereket, vagy újakat adhat hozzá, amikor különböző paraméterekkel futtat egy feladatot. Lásd: Feladat futtatása különböző paraméterekkel.
A feladatfuttatások javításakor felül is bírálhatja a feladatparamétereket. Lásd: Sikertelen és kihagyott feladatok újrafuttatása.