Membuat parameter pekerjaan

Artikel ini memberikan gambaran umum tentang menggunakan parameter dengan pekerjaan dan tugas, yang berfokus pada spesifikasi konfigurasi untuk pekerjaan dan tugas di UI. Anda juga harus memperbarui aset kode sumber yang Anda konfigurasi sebagai tugas ke parameter referensi. Referensi parameter bervariasi menurut bahasa dan jenis tugas. Lihat nilai parameter akses dari tugas.

Berikut ini adalah konsep dasar untuk memahami parameter untuk pekerjaan:

• Parameter kerja: Sepasang kunci-nilai yang ditentukan pada tingkat kerja dan diberikan ke tugas. Lihat Mengonfigurasi parameter pekerjaan.
• Parameter tugas: Pasangan kunci-nilai atau array JSON yang ditentukan pada tingkat tugas. Lihatlah Konfigurasikan parameter tugas.
• Referensi nilai dinamis: Sintaks untuk mereferensikan kondisi pekerjaan, metadata, dan parameter saat mengonfigurasi tugas. Lihat Apa itu referensi nilai dinamis?.
• Nilai tugas: Sintaks untuk menangkap dan mereferensikan nilai yang dihasilkan selama eksekusi tugas. Lihat bagian tentang cara menggunakan nilai tugas untuk meneruskan informasi antar tugas.

Apa yang dapat Anda lakukan dengan parameter?

Tambahkan parameter ke pekerjaan dan tugas untuk kasus penggunaan tingkat lanjut termasuk yang berikut ini:

• Tambahkan logika yang dapat diperluas ke aset kode.
• Jadikan eksekusi bersyarat.
• Mereferensikan parameter umum di beberapa tugas.
• Gunakan informasi yang dihasilkan dalam satu tugas di tugas lain.
• Referensi metadata dan informasi keadaan dalam pelaksanaan pekerjaan.

Apa perbedaan antara parameter pekerjaan dan tugas?

Parameter pekerjaan adalah pasangan kunci-nilai yang ditentukan pada tingkat pekerjaan. Anda dapat mengambil alih pengaturan default untuk parameter pekerjaan saat Anda Jalankan sekarang dengan parameter yang berbeda atau memicu eksekusi pekerjaan menggunakan REST API. Parameter pekerjaan didorong ke tugas yang menggunakan parameter nilai kunci. Tugas lain dapat mereferensikan parameter pekerjaan menggunakan referensi nilai dinamis.

Parameter tugas adalah pasangan kunci-nilai array JSON yang ditentukan di tingkat tugas. Setiap jenis tugas meneruskan nilai tugas ke aset kode yang dikonfigurasi secara berbeda. Misalnya, tugas buku catatan menggunakan submodul dbutils.widgets, sementara skrip Python meneruskan nilai sebagai argumen ke skrip seolah-olah dipanggil dari baris perintah. Tugas hilir dapat mengacu pada parameter tugas dari tugas hulu menggunakan referensi nilai dinamis. Lihat nilai parameter akses dari tugas.

Catatan

Beberapa tugas tidak memiliki bidang Parameter khusus, tetapi mengizinkan referensi ke nilai tugas atau referensi nilai dinamis dalam bidang lain. Lihat Contoh perintah dbt dengan parameter dan Tambahkan logika pencabangan ke pekerjaan dengan tugas If/else.

Membangun alur kerja menggunakan nilai dinamis

Parameter tugas yang diatur dengan nilai statis hanya dapat diganti dengan memperbarui definisi tugas. Mengatur nilai statis untuk parameter pekerjaan hanyalah mengonfigurasi nilai default, yang dapat Anda ganti ketika Anda Jalankan sekarang dengan parameter yang berbeda atau menjalankan eksekusi pekerjaan menggunakan REST API.

Gunakan referensi nilai dinamis saat menentukan parameter tugas untuk mengimplementasikan pola seperti berikut ini:

• Gunakan parameter pekerjaan sebagai output_table untuk satu tugas dan input_table untuk tugas lainnya.
• Ambil output kueri notebook sebagai daftar dan iterasi di atasnya dalam tugas For each.
• Membuat logika forking berdasarkan jumlah rekaman yang diproses menggunakan tugas kondisi If/else.
• Rujuk parameter dari tugas lain.

Lihat Apa itu referensi nilai dinamis?.