DataWorks：Gunakan parameter alur kerja

Jenis node yang didukung

Fitur parameter alur kerja hanya didukung untuk jenis node berikut: node ODPS SQL, node EMR Spark Shell, node EMR Spark, node EMR Shell, node EMR Hive, node EMR MR, node EMR Presto, node EMR Trino, node EMR Spark SQL, node EMR Spark Streaming, node EMR Streaming SQL, dan node Hologres SQL. Jenis node yang mendukung fitur ini dapat dilihat di konsol DataWorks.

Perhatian

• Setelah mengonfigurasi parameter alur kerja dan menyimpan konfigurasi, setiap kali Anda membuka node yang mendukung parameter alur kerja dalam alur kerja, sistem akan memuat konfigurasi terbaru dari parameter alur kerja ke daftar parameter node, sehingga node menjadi dapat diedit. Agar konfigurasi terbaru berlaku dalam skenario penjadwalan, Anda harus melakukan commit dan menerapkan node.

• Jika parameter alur kerja yang dikonfigurasikan sama dengan parameter node tetapi nilainya berbeda, nilai parameter alur kerja akan menimpa nilai parameter node.

• Saat mengonfigurasi parameter alur kerja, Anda tidak dapat menetapkan parameter Value/Expression dalam format ${English word}:. Sebagai contoh, Anda tidak dapat menentukan nilai parameter dalam format var:1 atau ekspresi parameter dalam format ${var}:1.

Pergi ke titik masuk untuk mengonfigurasi parameter alur kerja

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. Akses titik masuk untuk mengonfigurasi parameter alur kerja.

   Di panel Alur Kerja Terjadwal, temukan alur kerja yang diinginkan dan klik dua kali namanya. Di panel navigasi kanan tab konfigurasi alur kerja, klik Workflow Parameters.

Konfigurasikan parameter alur kerja

Metode untuk mengonfigurasi parameter alur kerja sama untuk semua jenis node yang mendukung fitur ini. Jika Anda perlu menetapkan nilai ke parameter yang sama yang digunakan di beberapa node dalam alur kerja secara bersamaan, disarankan untuk menggunakan fitur parameter alur kerja. Dalam contoh ini, fitur ini digunakan untuk mengganti nilai 20230613 dari parameter ReplaceMe dengan nilai 20230615 untuk node ODPS SQL dalam alur kerja yang dipicu otomatis.

1. Konfigurasikan parameter node untuk node ODPS SQL yang digunakan dalam pengembangan data.

   1. Buka tab konfigurasi node ODPS SQL.

      Klik dua kali node ODPS SQL dalam alur kerja yang diinginkan untuk membuka tab konfigurasi node.

   2. Konfigurasikan parameter node untuk node tersebut.

      Masukkan parameter ReplaceMe dan tetapkan nilai 20230613 ke parameter di bagian Parameter tab Properti, seperti yang ditunjukkan pada gambar berikut. Untuk informasi lebih lanjut tentang cara mengonfigurasi parameter node, lihat Konfigurasikan Parameter Penjadwalan.

2. Ganti nilai parameter ReplaceMe dari node ODPS SQL menggunakan fitur parameter alur kerja.

   1. Di panel Alur Kerja Terjadwal, temukan alur kerja yang diinginkan dan klik dua kali namanya. Di panel navigasi kanan tab konfigurasi alur kerja, klik Workflow Parameters.

   2. Di tab Workflow Parameters, konfigurasikan parameter Nama Parameter dan Nilai/Ekspresi.

      Pada gambar berikut, nilai parameter Nilai/Ekspresi diatur ke 20230615. Setelah menyimpan konfigurasi, nilai parameter ReplaceMe dari node ODPS SQL dalam alur kerja diganti dengan 20230615. Anda dapat mengklik Tambah di tab Parameter Alur Kerja untuk menambahkan parameter lain sesuai kebutuhan bisnis Anda.

      null

      • Jika parameter alur kerja yang dikonfigurasikan sama dengan parameter node tetapi nilainya berbeda, nilai parameter alur kerja akan menimpa nilai parameter node.

      • Saat mengonfigurasi parameter alur kerja, Anda tidak dapat menetapkan parameter Value/Expression dalam format ${English word}:. Sebagai contoh, Anda tidak dapat menentukan nilai parameter dalam format var:1 atau ekspresi parameter dalam format ${var}:1.

      Gambar berikut menunjukkan bagaimana nilai parameter node dari node ODPS SQL diganti.

Periksa apakah konfigurasi parameter alur kerja berlaku

Setelah mengonfigurasi parameter alur kerja, jalankan alur kerja untuk memeriksa apakah nilai yang ditentukan untuk parameter alur kerja mengganti nilai parameter node.

1. Jalankan alur kerja dan tetapkan nilai untuk setiap parameter alur kerja.

   Jika parameter alur kerja digunakan dalam alur kerja yang ingin dijalankan, Anda harus secara manual menetapkan nilai untuk setiap parameter alur kerja. Untuk informasi lebih lanjut tentang metode pelaksanaan, lihat Prosedur Debugging.

   1. Di bilah alat atas tab konfigurasi alur kerja, klik ikon .

   2. Di kotak dialog Enter parameters, tetapkan nilai 20230615 untuk parameter alur kerja ReplaceMe.

2. Lihat hasil pelaksanaan.

   Di tab konfigurasi alur kerja, klik kanan node ODPS SQL dan pilih View Log. Kemudian, Anda dapat melihat nilai yang ditetapkan untuk parameter ReplaceMe dari node ODPS SQL. Nilai parameter node dari node ODPS SQL berubah dari 20230613 menjadi 20230615. Ini menunjukkan bahwa parameter alur kerja berlaku dan alur kerja berjalan sesuai harapan.

Lakukan commit dan terapkan parameter alur kerja

Setelah mengonfirmasi bahwa parameter alur kerja dikonfigurasi dengan benar, Anda harus melakukan commit dan menerapkan alur kerja saat ini. Setelah alur kerja di-commit dan diterapkan, parameter alur kerja dapat berlaku dalam skenario penjadwalan.

1. Commit alur kerja.

   Ikuti langkah-langkah yang ditunjukkan pada gambar berikut untuk melakukan commit alur kerja. Di kotak dialog Commit yang muncul setelah Anda klik Submit, pilih node yang ingin di-commit dan konfigurasikan parameter Deskripsi Perubahan.

   null

   Anda dapat menentukan apakah akan menggunakan fitur tinjauan kode berdasarkan kebutuhan bisnis Anda. Jika Anda ingin menggunakan fitur tersebut, kode node yang dipilih hanya dapat diterapkan jika lolos tinjauan.

   

2. Terapkan alur kerja.

   Jika alur kerja dibuat di ruang kerja dalam mode standar, setelah alur kerja di-commit, Anda harus mengklik ikon Deploy di pojok kanan atas tab konfigurasi alur kerja untuk menerapkan node dalam alur kerja. Untuk informasi lebih lanjut, lihat Terapkan Node.