Parameter input dan output digunakan untuk mengirimkan pengaturan parameter antara node leluhur dan node turunan. Topik ini menjelaskan cara mendefinisikan dan menggunakan parameter input dan output.
Informasi latar belakang
Setelah Anda menentukan parameter output beserta nilainya untuk suatu node, Anda dapat menentukan parameter input untuk node turunannya dan mengonfigurasinya agar mereferensikan nilai parameter output tersebut.
Perhatian
Deskripsi transmisi parameter dan transmisi hasil kueri:
Passing parameter: Untuk meneruskan informasi parameter dari node hulu ke node hilir, Anda dapat mengatur Output Parameter di bagian Node Context Parameters pada node hulu sebagai Input Parameter di bagian Node Context Parameters pada node hilir.
Pass hasil kueri: Untuk meneruskan hasil kueri dari node hulu ke node hilir, Anda dapat mengatur Assignment Parameter di bagian Node Context Parameters pada node hulu sebagai Input Parameter di bagian Node Context Parameters pada node hilir. Anda juga dapat menggunakan assignment node untuk meneruskan hasil kueri tersebut.
CatatanPenerusan hasil kueri hanya didukung untuk node tertentu, seperti EMR Hive, EMR Spark SQL, ODPS Script, Hologres SQL, AnalyticDB for PostgreSQL, Click House SQL, dan node MySQL. Fitur ini berfungsi serupa dengan assignment node. Untuk petunjuk konfigurasi, lihat Assignment node.
Batasan
Fitur Use Assignment Parameters hanya didukung di DataWorks Edisi Standar atau edisi yang lebih tinggi.
Akses bagian konfigurasi parameter
Masuk ke Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Di panel navigasi sebelah kiri, pilih . Pada halaman yang muncul, pilih ruang kerja yang diinginkan dari daftar drop-down dan klik Go to Data Development.
Di panel Data Development, klik ganda node yang diinginkan untuk membuka halaman edit.
Klik Scheduling Configuration di sebelah kanan, lalu di bagian Node Context Parameters, klik ikon
di sebelah kanan. Hal ini akan membuka bagian konfigurasi parameter konteks node.CatatanUntuk informasi selengkapnya tentang cara mengonfigurasi parameter penjadwalan, lihat Node tipe SQL dan node sinkronisasi offline.
Konfigurasi parameter output
Saat Anda mengonfigurasi parameter output untuk node saat ini di bagian Node Context Parameters, Anda dapat mengaturnya sesuai kebutuhan.
Konfigurasi parameter output standar: Anda dapat meneruskan parameter output konstan atau variabel yang dikonfigurasi untuk node saat ini ke node hilir.
Konfigurasi parameter output assignment: Anda dapat mengonfigurasi hasil kueri node saat ini sebagai parameter output dan meneruskannya ke node hilir untuk digunakan.
Konfigurasi parameter output reguler
Jika Anda ingin meneruskan informasi parameter yang dikonfigurasi di node leluhur ke node turunan, rujuk konten berikut.
Parameter | Deskripsi konfigurasi |
No. | Nomor seri, yang secara otomatis bertambah 1 setiap kali Anda menentukan parameter input. |
Parameter Name | Anda perlu menyesuaikan nama parameter output. |
Type | Mendukung Constant dan Variable. Anda dapat memilih dan mengonfigurasinya sesuai kebutuhan. |
Value | Nilai parameter output. Jenis nilai dapat berupa Constant atau Variable:
|
Description | Deskripsi parameter. |
Source | Cara parameter didefinisikan. Nilai yang valid: Added Automatically, Auto Parse, dan Added Manually. |
Actions | Menyediakan operasi Save, Edit, dan Delete. Catatan Edit dan hapus tidak didukung ketika node hilir bergantung pada node ini. Sebelum Anda mengonfigurasi node hilir untuk mereferensikan node hulu, periksa dengan cermat untuk memastikan bahwa output hulu telah didefinisikan dengan benar. |
Setelah Anda mengonfigurasi parameter terkait, klik Save di kolom Actions.
Konfigurasi parameter output assignment
Jika Anda ingin meneruskan hasil kueri tugas saat ini sebagai parameter ke tugas hilir, rujuk konten berikut.
Temukan bagian dari node tersebut.
Klik Add Assignment Parameter untuk menambahkan parameter assignment output.
Setelah Anda mengklik Add Assignment Parameter, parameter assignment akan meneruskan hasil kueri node saat ini ke node hilir yang mereferensikan parameter ini. Jika kueri mengembalikan hasil kosong, node saat ini tidak diblokir, tetapi node hilir yang mereferensikan parameter tersebut mungkin gagal.
Node hilir harus menambahkan parameter assignment dari node hulu ke parameter input-nya. Parameter ini digunakan dengan cara yang sama seperti assignment node yang menggunakan ODPS SQL. Untuk informasi selengkapnya, lihat Assignment node.
Setelah Anda mengonfigurasi Output Parameters For This Node, Anda dapat menemukan Output Name yang memiliki Add Method berupa Added By System di bagian . Node hilir dapat menggunakan Output Name ini untuk membuat dependensi terhadap node saat ini.
Konfigurasi parameter input
Anda dapat mengonfigurasi parameter input di bagian Input and Output Parameters untuk mendapatkan parameter output dari node hulu guna digunakan dalam node saat ini.
Anda dapat menentukan parameter input untuk suatu node agar mereferensikan parameter output yang didefinisikan untuk node leluhurnya. Anda dapat menggunakan parameter input tersebut dalam kode node dengan cara yang sama seperti penugasan parameter penjadwalan ke variabel dalam kode node.
Setelah Anda mengonfigurasi dependensi penjadwalan agar node saat ini bergantung pada suatu node, node saat ini dapat mereferensikan parameter output yang didefinisikan untuk node leluhurnya sebagai parameter input untuk node saat ini di bagian Input Parameters.
Konfigurasi parameter output untuk node leluhur.
Konfigurasi dependensi.
Klik Scheduling Configuration di sisi kanan halaman konfigurasi untuk node hilir.
Di kotak teks untuk Node Output di bawah , masukkan dan pilih Output Name yang telah Anda tentukan untuk node hulu di Konfigurasi parameter output.
Klik Add.
Konfigurasi parameter input untuk node hilir.
Di bagian Node Context Parameters, klik Add untuk menambahkan parameter input untuk node saat ini. Untuk informasi tentang parameter tersebut, lihat tabel berikut:
Parameter
Deskripsi konfigurasi
No.
Nomor seri, yang secara otomatis bertambah 1 setiap kali Anda menentukan parameter input.
Parameter Name
Anda perlu menyesuaikan nama parameter output. Nantinya, Anda dapat mereferensikan informasi parameter yang diteruskan dari node hulu melalui nama parameter ini di halaman edit node.
Value Source
Nilai parameter berasal dari parameter output node hulu, dan nilai spesifiknya adalah hasil output aktual dari node hulu tersebut.
Description
Anda dapat menyesuaikan deskripsi singkat untuk parameter tersebut.
Parent Node ID
Sistem mengurai ID node leluhur.
Source
Cara parameter didefinisikan.
Nilai yang valid: Added Automatically, Auto Parse, dan Added Manually.
Actions
Menyediakan operasi Save, Edit, dan Delete.
Setelah Anda mengonfigurasi parameter terkait, klik Save di kolom Actions.
Gunakan parameter input
Anda dapat menggunakan parameter input yang telah didefinisikan dalam suatu node dengan cara yang sama seperti parameter penjadwalan bawaan lainnya, yaitu dengan mereferensikannya dalam format ${Nama parameter input}. Contoh berikut menunjukkan cara mereferensikan parameter tersebut dalam node Shell.

Anda harus menjalankan alur kerja tempat node leluhur dan node saat ini berada untuk memastikan bahwa node leluhur dan node saat ini dijalankan secara berurutan. Jika tidak, parameter input yang didefinisikan untuk node saat ini tidak akan berlaku.
Parameter penjadwalan bawaan yang didukung
Variabel sistem
Variabel sistem
Deskripsi
${projectId}
ID proyek.
${projectName}
Nama proyek MaxCompute.
${nodeId}
ID node.
${gmtdate}
Waktu pukul 00:00:00 pada hari ketika instans dijadwalkan berjalan, dalam format yyyy-MM-dd 00:00:00.
${taskId}
ID instans tugas.
${seq}
Nomor urut instans tugas, yang menunjukkan peringkat instans ini di antara semua instans dari node yang sama pada hari yang sama.
${cyctime}
Waktu ketika instans node dijadwalkan berjalan.
${status}
Status instans. Nilai yang valid: SUCCESS dan FAILURE.
${bizdate}
Waktu data.
${finishTime}
Waktu ketika instans node selesai berjalan.
${taskType}
Mode di mana instans dijalankan. Nilai yang valid: NORMAL, MANUAL, PAUSE, SKIP, UNCHOOSE, dan SKIP_CYCLE.
${nodeName}
Nama node.
Untuk informasi selengkapnya tentang parameter lainnya, lihat Format parameter penjadwalan yang didukung.