Mengonfigurasi parameter pekerjaan
Artikel ini menjelaskan fungsionalitas parameter pekerjaan dan mengonfigurasi parameter pekerjaan dengan UI ruang kerja Databricks. Anda juga dapat menambahkan parameter pekerjaan ke definisi JSON dan YAML yang digunakan dengan REST API, CLI, dan DAB. Lihat API Pekerjaan, Apa itu Databricks CLI?, dan Apa itu Bundel Aset Databricks?.
Apa itu parameter pekerjaan?
Parameter pekerjaan adalah pasangan kunci-nilai yang memungkinkan Anda membuat parameter pekerjaan dengan nilai statis atau dinamis default. Anda dapat secara opsional mengambil alih parameter yang dikonfigurasi dalam pekerjaan saat memicu eksekusi baru. Lihat Menjalankan pekerjaan dengan parameter yang berbeda.
Kunci parameter pekerjaan hanya dapat berisi _ - . atau karakter alfanumerik. Nilai parameter ditetapkan sebagai string atau referensi nilai dinamis. Lihat Apa itu referensi nilai dinamis?.
Catatan
Anda dapat menggunakan JSON yang valid sebagai nilai parameter. Misalnya, For each jenis tugas dapat mengurai daftar seperti berikut ini:
[1, 2, 3]
['a', 'b', 'c']
Menambahkan atau mengedit parameter pekerjaan
Gunakan dialog parameter Pekerjaan untuk menambahkan parameter baru, mengedit kunci dan nilai parameter yang ada, atau menghapus parameter.
Untuk mengedit parameter dengan UI ruang kerja, pilih pekerjaan yang sudah ada menggunakan langkah-langkah berikut:
- Klik
Alur Kerja di bilah samping. - Di kolom Nama, klik nama pekerjaan.
- Di bilah samping detail Pekerjaan
, klik Edit parameter . Dialog parameter pekerjaan muncul. - Tambahkan atau edit parameter menggunakan bidang Kunci dan Nilai.
- Klik
untuk menghapus parameter. - Klik Simpan untuk menerapkan perubahan Anda.
Catatan
Klik { } untuk mencantumkan referensi nilai dinamis yang tersedia. Pilih opsi dari daftar untuk memasukkannya ke dalam bidang Nilai .
Pushdown parameter pekerjaan
Parameter pekerjaan secara otomatis diteruskan sebagai parameter kunci-nilai ke semua tugas yang menerima parameter kunci-nilai, yang mencakup jenis tugas berikut:
- Notebook
- Roda Python (hanya ketika dikonfigurasi dengan argumen kata kunci)
- Kueri SQL, dasbor warisan, atau file
- Jalankan Pekerjaan
Parameter pekerjaan yang diteruskan ke tugas terlihat dalam konfigurasi tugas di UI bersama parameter tugas yang dikonfigurasi.
Penting
Parameter pekerjaan lebih diutamakan daripada parameter tugas. Jika parameter pekerjaan dan parameter tugas memiliki kunci yang sama, parameter pekerjaan akan mengambil alih parameter tugas.
Referensi nilai dinamis ke parameter pekerjaan
Semua tugas yang menerima referensi nilai dinamis dapat mengakses parameter pekerjaan.
Gunakan referensi {{job.parameters.<name>}}nilai dinamis , mengganti <name> dengan key yang mengidentifikasi parameter.
Menjalankan pekerjaan dengan parameter yang berbeda
Anda dapat mengambil alih parameter pekerjaan yang dikonfigurasi atau menambahkan yang baru saat menjalankan pekerjaan dengan parameter yang berbeda. Lihat Menjalankan tugas dengan parameter yang berbeda.
Anda juga dapat menggantikan parameter pekerjaan ketika memperbaiki pelaksanaan pekerjaan. Lihat Menjalankan kembali tugas yang gagal dan dilewati.