Parameter node adalah jenis khusus dari node virtual yang digunakan untuk mengelola parameter dalam alur kerja dan meneruskan parameter antar-node. Parameter node dapat mengelola parameter konstan dan variabel serta meneruskan secara transparan parameter dari node leluhur. Node yang memerlukan parameter tersebut dapat memperolehnya dari parameter node. Topik ini menjelaskan cara membuat parameter node.
Informasi latar belakang
Parameter node merupakan node virtual yang tidak menjalankan tugas komputasi. Fungsinya hanya untuk meneruskan parameter antar-node dan mengelola parameter dalam alur kerja.
-
Parameter passing between nodes
Jika Node A dalam suatu alur kerja perlu memperoleh parameter output dari node leluhurnya, Anda dapat membuat parameter node dan menjadikannya sebagai node leluhur dari Node A sekaligus node turunan dari node leluhur Node A. Kemudian, tambahkan semua parameter yang diperlukan oleh Node A ke parameter node tersebut. Dengan demikian, Node A dapat memperoleh semua parameter yang dibutuhkan dari parameter node tersebut.
Pada gambar di atas, node sql_7 perlu memperoleh parameter output dari node sql_1, sql_3, dan sql_4. Sebuah parameter node dibuat dan digunakan sebagai node turunan dari node sql_1, sql_3, dan sql_4 serta sebagai node leluhur dari node sql_7. Semua parameter yang diperlukan oleh node sql_7 ditambahkan ke parameter node tersebut, sehingga node sql_7 dapat memperoleh semua parameter yang dibutuhkan dari parameter node tersebut. -
Parameter management
Jika beberapa node dalam alur kerja perlu menggunakan parameter konstan dan variabel tertentu, Anda dapat membuat parameter node dan menjadikannya sebagai node leluhur dari node-node tersebut. Lalu, tambahkan semua parameter yang diperlukan ke parameter node tersebut. Dengan begitu, node-node tersebut dapat memperoleh semua parameter yang dibutuhkan dari parameter node tersebut. Pendekatan ini mempermudah pengelolaan terpusat seluruh parameter yang digunakan dalam alur kerja.
Pada gambar di atas, node sql_3, sql_4, sql_5, dan sql_7 perlu menggunakan beberapa parameter. Sebuah parameter node dibuat dan digunakan sebagai node leluhur dari node sql_3, sql_4, sql_5, dan sql_7. Semua parameter yang diperlukan oleh node-node tersebut ditambahkan ke parameter node tersebut, sehingga mereka dapat memperoleh semua parameter yang dibutuhkan dari parameter node tersebut.
Perhatian
Jika suatu node perlu menggunakan parameter dari parameter node, node tersebut harus merupakan node turunan langsung dari parameter node tersebut.
Batasan
Wilayah yang didukung: 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 parameter node
Masuk ke Konsol DataWorks. Di wilayah target, klik di panel navigasi sebelah kiri. Pilih ruang kerja dari daftar drop-down, lalu klik Go to Data Development.
-
Pada halaman DataStudio, arahkan kursor ke ikon
dan pilih .Atau, buka alur kerja, klik kanan General, lalu pilih .
-
Pada kotak dialog Create Node, masukkan Name dan pilih Path.
-
Klik OK.
Konfigurasikan properti penjadwalan untuk parameter node
Setelah parameter node dibuat, Anda dapat mengonfigurasi properti penjadwalan sesuai kebutuhan bisnis.
Properti penjadwalan mencakup properti dasar, properti waktu, properti sumber daya, dan dependensi penjadwalan. Parameter node tidak menjalankan tugas pengembangan data. Fungsinya hanya untuk mengelola parameter dan meneruskan parameter secara transparan. Oleh karena itu, Anda harus memberikan perhatian khusus pada dependensi penjadwalan yang dikonfigurasi untuk parameter node.
-
Jika suatu node perlu menggunakan parameter dari parameter node, node tersebut harus merupakan node turunan dari parameter node tersebut.
-
Node leluhur yang parameternya perlu diteruskan secara transparan harus menjadi node leluhur dari parameter node tersebut.
Untuk informasi lebih lanjut tentang cara mengonfigurasi properti penjadwalan untuk parameter node, lihat Configure basic properties, Configure time properties, Configure the resource property, dan Configure same-cycle scheduling dependencies.
Tambahkan parameter ke parameter node
Setelah mengonfigurasi properti penjadwalan untuk parameter node, Anda dapat menambahkan parameter yang ingin dikelola dan diteruskan secara transparan ke parameter node tersebut untuk pengelolaan dan penggunaan selanjutnya. Bagian ini menjelaskan prosedurnya secara rinci.
-
Pada halaman konfigurasi parameter node, klik Add Parameter.
-
Konfigurasikan Parameter name, Type, Value, dan Description, lalu klik Save.
Catatan di bagian atas halaman mengingatkan bahwa setiap node yang mereferensikan parameter ini harus merupakan node turunan langsung dari parameter node ini. Jenis parameter meliputi Constant, Variable, dan Pass-through Variable.
-
Constant: Parameter memiliki nilai tetap.
-
Variable: Nilai parameter bersifat dinamis. Pilih jenis ini jika Anda perlu menggunakan variabel sistem, seperti waktu saat ini. Untuk informasi lebih lanjut tentang format yang didukung, lihat Supported formats for scheduling parameters.
-
Pass-through Variable: Meneruskan parameter output dari node leluhur langsung ke node turunan. Untuk jenis ini, Anda memilih nilainya dari daftar semua parameter output yang tersedia dari node leluhur langsung dari parameter node ini.
-
Langkah berikutnya: Gunakan parameter dalam parameter node
Setelah mengonfigurasi parameter node, node turunan dari parameter node tersebut dapat langsung menggunakan parameternya. Hal ini mempermudah pengelolaan terpusat parameter dan meningkatkan efisiensi pengembangan tugas pada node turunan.
Sebelum node turunan dapat menggunakan parameter dari parameter node, Anda harus mengonfigurasi parameter tersebut sebagai parameter input dari node turunan. Dengan begitu, parameter tersebut dapat langsung digunakan dalam kode node turunan.
-
Konfigurasikan parameter sebagai parameter input dari node turunan.
Untuk node turunan tersebut, buka bagian . Pada subbagian Input Parameters, klik Add. Masukkan nama parameter, pilih sumber nilai, lalu klik Save. Pengaturannya adalah sebagai berikut:
-
Parameter Name: nama parameter yang perlu digunakan oleh node turunan. Anda dapat melihat nama parameter tersebut di parameter node.
-
Value Source: sumber parameter yang perlu digunakan oleh node turunan.
Jika informasi parameter tidak sepenuhnya ditampilkan, arahkan kursor ke elemen tersebut untuk melihat informasi lengkapnya. Semua parameter yang ditambahkan ke parameter node akan ditampilkan dalam format Output name of the parameter node:Parameter name. Anda dapat memilih nama sumber yang diakhiri dengan nama parameter yang dibutuhkan.
-
-
Gunakan parameter dalam kode node turunan.