全部产品
Search
文档中心

DataWorks:Buat sebuah simpul parameter

更新时间:Jul 02, 2025

Simpul parameter adalah jenis simpul virtual khusus yang digunakan untuk mengelola parameter dalam alur kerja dan meneruskan parameter antar simpul. Simpul ini dapat mengelola parameter konstan dan variabel serta secara transparan meneruskan parameter dari simpul leluhur. Topik ini menjelaskan cara membuat simpul parameter.

Informasi latar belakang

Simpul parameter adalah simpul virtual yang tidak menjalankan tugas komputasi. Mereka digunakan untuk meneruskan parameter antar simpul dan mengelola parameter dalam alur kerja.

  • Parameter passing between nodes

    Jika Simpul A dalam alur kerja perlu mendapatkan parameter keluaran dari simpul leluhurnya, Anda dapat membuat simpul parameter dan menggunakannya sebagai simpul leluhur dari Simpul A dan sebagai simpul keturunan dari simpul leluhur Simpul A. Tambahkan semua parameter yang diperlukan oleh Simpul A ke simpul parameter sehingga Simpul A dapat memperoleh semua parameter yang diperlukan dari simpul parameter.

    跨节点传参Pada gambar di atas, simpul sql_7 perlu mendapatkan parameter keluaran dari simpul sql_1, sql_3, dan sql_4. Sebuah simpul parameter dibuat dan digunakan sebagai simpul keturunan dari simpul sql_1, sql_3, dan sql_4 serta sebagai simpul leluhur dari simpul sql_7. Semua parameter yang diperlukan oleh simpul sql_7 ditambahkan ke simpul parameter, sehingga simpul sql_7 dapat memperoleh semua parameter yang diperlukan dari simpul parameter.

  • Parameter management

    Jika simpul dalam alur kerja perlu menggunakan beberapa parameter konstan dan variabel, Anda dapat membuat simpul parameter dan menggunakannya sebagai simpul leluhur dari simpul-simpul tersebut. Tambahkan semua parameter yang diperlukan oleh simpul-simpul tersebut ke simpul parameter sehingga mereka dapat memperoleh semua parameter yang diperlukan dari simpul parameter. Simpul parameter memfasilitasi manajemen terpusat dari semua parameter yang digunakan dalam alur kerja.

    参数管理Pada gambar di atas, simpul sql_3, sql_4, sql_5, dan sql_7 perlu menggunakan beberapa parameter. Sebuah simpul parameter dibuat dan digunakan sebagai simpul leluhur dari simpul sql_3, sql_4, sql_5, dan sql_7. Semua parameter yang diperlukan oleh simpul-simpul tersebut ditambahkan ke simpul parameter, sehingga simpul-simpul tersebut dapat memperoleh semua parameter yang diperlukan dari simpul parameter.

Perhatian

Jika sebuah simpul perlu menggunakan parameter dalam simpul parameter, simpul tersebut harus menjadi simpul keturunan langsung dari simpul parameter.

Batasan

Jenis simpul ini didukung di wilayah berikut: Tiongkok (Hangzhou), Tiongkok (Shanghai), Tiongkok (Beijing), Tiongkok (Shenzhen), Tiongkok (Chengdu), Tiongkok (Hong Kong), Jepang (Tokyo), Singapura, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Jerman (Frankfurt), Inggris (London), AS (Silicon Valley), dan AS (Virginia).

Buat sebuah simpul parameter

  1. Buka halaman DataStudio.

    Masuk ke Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Di panel navigasi sisi 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 halaman DataStudio, gerakkan penunjuk mouse ke atas ikon 新建 dan pilih Create Node > General > Parameter Node.

    Sebagai alternatif, temukan alur kerja yang diperlukan di panel Alur Kerja Terjadwal, klik nama alur kerja, klik kanan General, dan pilih Create Node > Parameter nodes.

  3. Dalam kotak dialog Create Node, konfigurasikan parameter Name dan Path.

  4. Klik Confirm.

Konfigurasikan properti penjadwalan untuk simpul parameter

Setelah simpul parameter dibuat, Anda dapat mengonfigurasi properti penjadwalan sesuai dengan kebutuhan bisnis Anda.

Properti penjadwalan mencakup properti dasar, properti waktu, properti sumber daya, dan dependensi penjadwalan. Simpul parameter tidak menjalankan tugas pengembangan data, tetapi hanya digunakan untuk mengelola parameter dan secara transparan meneruskan parameter. Oleh karena itu, berikan perhatian khusus pada dependensi penjadwalan yang dikonfigurasi untuk simpul parameter.

  • Jika sebuah simpul perlu menggunakan parameter dalam simpul parameter, simpul tersebut harus menjadi simpul keturunan dari simpul parameter.

  • Simpul leluhur yang parameternya perlu diteruskan secara transparan harus menjadi simpul leluhur dari simpul parameter.

Untuk informasi lebih lanjut tentang cara mengonfigurasi properti penjadwalan untuk simpul parameter, lihat Konfigurasikan Properti Dasar, Konfigurasikan Properti Waktu, Konfigurasikan Properti Sumber Daya, dan Konfigurasikan Dependensi Penjadwalan Siklus yang Sama.

Tambahkan parameter ke simpul parameter

Setelah mengonfigurasi properti penjadwalan untuk simpul parameter, Anda dapat menambahkan parameter yang ingin Anda kelola dan teruskan secara transparan ke simpul parameter untuk pengelolaan dan penggunaan selanjutnya. Bagian ini menjelaskan prosedur secara rinci.

  1. Di tab konfigurasi simpul parameter, klik Add.

  2. Tentukan Parameter name, Parameter Type, Value, dan Description, lalu klik Save.

    添加参数Nilai valid dari Tipe meliputi Constant, Variable, dan Pass-through variable.

    • Constant: Menunjukkan bahwa nilai parameter bersifat konstan.

    • Variable: Menunjukkan bahwa nilai parameter bersifat variabel. Jika Anda ingin menggunakan variabel seperti waktu sistem, atur nilai Tipe ke Variabel. Untuk informasi lebih lanjut tentang parameter variabel, lihat Format yang Didukung dari Parameter Penjadwalan.

    • Pass-through variable: Variabel pass-through digunakan untuk secara transparan meneruskan parameter keluaran dari simpul leluhur simpul parameter ke simpul keturunan simpul parameter. Jika Anda menambahkan parameter tipe variabel pass-through, Anda dapat mengatur Nilai Valid ke parameter keluaran dari simpul leluhur simpul parameter.

Apa yang harus dilakukan selanjutnya: Gunakan parameter dalam simpul parameter

Setelah mengonfigurasi simpul parameter, simpul keturunan dari simpul parameter dapat langsung menggunakan parameter dalam simpul parameter. Ini memfasilitasi manajemen terpusat parameter dan meningkatkan efisiensi pengembangan tugas simpul keturunan.

Sebelum simpul keturunan dari simpul parameter dapat menggunakan parameter dalam simpul parameter, Anda harus mengonfigurasi parameter sebagai parameter masukan dari simpul keturunan. Dengan cara ini, parameter tersebut dapat langsung digunakan dalam kode simpul keturunan.

  1. Konfigurasikan parameter sebagai parameter masukan dari simpul keturunan.

    Di tab konfigurasi simpul keturunan, klik Properties di panel navigasi sisi kanan. Di tab Properti, klik Create di bagian Input Parameters dari Input and Output Parameters untuk menambahkan parameter yang diperlukan oleh simpul keturunan. 节点上下文Parameter berikut dalam bagian Parameter Masukan harus ditentukan:

    • Nama Parameter: Nama parameter yang perlu digunakan oleh simpul keturunan. Anda dapat melihat nama parameter di simpul parameter.

    • Sumber Nilai: Sumber parameter yang perlu digunakan oleh simpul keturunan.

      Jika informasi parameter tidak sepenuhnya ditampilkan, Anda dapat menggerakkan penunjuk mouse di atasnya untuk melihat informasi lengkap. Semua parameter yang ditambahkan ke simpul parameter ditampilkan dalam format Output name of the parameter node:Parameter name. Anda dapat memilih nama sumber yang diakhiri dengan nama parameter yang diperlukan.

  2. Gunakan parameter dalam kode simpul keturunan.