全部产品
Search
文档中心

DataWorks:Konfigurasi konteks node

更新时间:Nov 10, 2025

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.

    Catatan

    Penerusan 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

  1. Masuk ke Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Di panel navigasi sebelah kiri, pilih Data Development and O&M > Data Development. Pada halaman yang muncul, pilih ruang kerja yang diinginkan dari daftar drop-down dan klik Go to Data Development.

  2. Di panel Data Development, klik ganda node yang diinginkan untuk membuka halaman edit.

  3. Klik Scheduling Configuration di sebelah kanan, lalu di bagian Node Context Parameters, klik ikon image di sebelah kanan. Hal ini akan membuka bagian konfigurasi parameter konteks node.

    Catatan

    Untuk 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 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:

  • Jika bidang Type diatur ke Constant, nilainya adalah string tetap.

  • Variabel mencakup variabel global yang didukung sistem, parameter bawaan penjadwalan, parameter kustom ${…}, dan parameter kustom $[…].

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.

  1. Temukan bagian Node Context Parameters > Output Parameters dari node tersebut.

  2. Klik Add Assignment Parameter untuk menambahkan parameter assignment output.

Catatan

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 Scheduling Dependencies > Output Names For This Node. 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.

Catatan
  • 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.

  1. Konfigurasi parameter output untuk node leluhur.

  2. Konfigurasi dependensi.

    1. Klik Scheduling Configuration di sisi kanan halaman konfigurasi untuk node hilir.

    2. Di kotak teks untuk Node Output di bawah Scheduling Dependencies > Dependent Upstream Nodes, masukkan dan pilih Output Name yang telah Anda tentukan untuk node hulu di Konfigurasi parameter output.

    3. Klik Add.

  3. 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.

  4. 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.

image

Catatan

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.