Parameter tingkat ruang kerja memungkinkan Anda menetapkan pasangan kunci-nilai satu kali dan menggunakannya kembali di semua task dalam suatu ruang kerja—tanpa perlu menyetel nilai yang sama berulang kali pada masing-masing task. Fitur ini berguna ketika beberapa task berbagi nilai konfigurasi yang sama, seperti string koneksi database atau rentang tanggal bersama.
Parameter tingkat ruang kerja berbeda dari parameter penjadwalan tingkat task. Parameter tingkat task hanya berlaku untuk satu task, sedangkan parameter tingkat ruang kerja berlaku untuk semua task dalam ruang kerja tersebut.
Prasyarat
Sebelum memulai, pastikan Anda telah memiliki:
-
Ruang kerja. Lihat Mengelola ruang kerja.
-
Peran Workspace Administrator di ruang kerja tersebut. Hanya Workspace Administrator yang dapat membuat parameter tingkat ruang kerja. Lihat Menambahkan Pengguna RAM ke ruang kerja sebagai anggota dan menetapkan peran kepada anggota tersebut.
-
DataWorks Edisi Profesional atau edisi yang lebih tinggi. Lihat Perbedaan antar edisi DataWorks.
-
Grup sumber daya eksklusif untuk penjadwalan. Resource yang dibagikan tidak mendukung fitur ini.
Jika grup sumber daya eksklusif Anda dibuat sebelum 1 Januari 2024, hubungi dukungan teknis untuk melakukan upgrade konfigurasi grup sumber daya sebelum menggunakan parameter tingkat ruang kerja.
Cara kerja
Saat sebuah task dijalankan, DataWorks mengganti setiap variabel dalam kode task tersebut dengan nilai parameter tingkat ruang kerja yang telah ditetapkan. Proses penggantian ini mengikuti aturan yang sama seperti parameter penjadwalan tingkat task—lihat Format parameter penjadwalan yang didukung.
Dalam ruang kerja ber-mode standard mode, Anda dapat menetapkan nilai berbeda untuk parameter yang sama di lingkungan pengembangan dan produksi. Misalnya, Anda dapat mengarahkan parameter db.endpoint ke database uji di lingkungan pengembangan dan ke database produksi di lingkungan produksi—tanpa mengubah kode task apa pun.
Buat parameter tingkat ruang kerja
-
Masuk ke Konsol DataWorks. Di bilah navigasi atas, pilih Wilayah target.
-
Di panel navigasi kiri, pilih Data Development and O&M > Operation Center. Pilih ruang kerja target dari daftar drop-down, lalu klik Go to Operation Center.
-
Di panel navigasi kiri halaman Operation Center, pilih Other > Tenant Schedule Setting, lalu klik tab Workspace-level Parameters.
-
Klik Create Workspace-level Parameter.
CatatanUntuk membuat beberapa parameter sekaligus, klik Batch Create Workspace-level Parameters sebagai gantinya.
-
Pada kotak dialog Create Workspace-level Parameter, konfigurasikan bidang-bidang berikut.
CatatanNilai parameter dapat mencakup karakter khusus tertentu. Periksa Konsol DataWorks untuk mengetahui set karakter yang didukung. Nilai parameter tingkat ruang kerja tidak dapat mereferensikan parameter tingkat ruang kerja lainnya.
Field Description Parameter name Nama unik untuk parameter tersebut. Nama secara default diberi awalan workspace.Owner Anggota ruang kerja yang menjadi pemilik parameter ini. Workspace Administrator dapat menetapkan anggota mana pun sebagai pemilik. Hanya Workspace Administrator yang dapat memodifikasi atau menghapus parameter apa pun, terlepas dari kepemilikannya. Workspace Ruang kerja tempat parameter tersedia. Semua task dalam ruang kerja ini dapat mereferensikan parameter tersebut. Setiap parameter hanya berlaku dalam satu ruang kerja. Daftar drop-down hanya menampilkan ruang kerja tempat Anda menjadi Workspace Administrator. Parameter type Mengontrol cara nilai disimpan dan ditampilkan. Lihat tabel di bawah. Parameter value (development environment) Nilai yang digunakan di lingkungan pengembangan. Hanya tersedia di ruang kerja ber-mode standard mode. Parameter value (production environment) Nilai yang digunakan di lingkungan produksi. Hanya tersedia di ruang kerja ber-mode standard mode. Parameter types:
Type Behavior Example Constant (Plaintext) Nilai disimpan dan ditampilkan apa adanya, terlihat oleh semua anggota ruang kerja. cn-hangzhou.oss.aliyuncs.comConstant (Ciphertext) Nilai disembunyikan sebagai ******di konsol. Gunakan jenis ini untuk nilai konfigurasi sensitif seperti password atau access key.Password yang ditampilkan sebagai ******Variable Nilai diganti secara dinamis saat runtime berdasarkan ekspresi penjadwalan. $[yyyy-mm-dd]merujuk pada waktu jadwal eksekusi task;${yyyy-mm-dd}merujuk pada Waktu data task tersebut. Lihat Format parameter penjadwalan yang didukung.$[yyyy-mm-dd] -
Klik OK.
Gunakan parameter tingkat ruang kerja dalam node
-
Di editor kode node, definisikan variabel menggunakan sintaks parameter penjadwalan standar.
-
Di tab konfigurasi node, klik Properties di panel kanan. Di bagian Scheduling Parameter, tetapkan parameter tingkat ruang kerja ke variabel tersebut.
-
Pratinjau nilai parameter yang telah diselesaikan untuk memastikan sesuai harapan Anda.
-
Simpan dan kirimkan konfigurasi node menggunakan bilah alat di bagian atas.
Untuk detail tentang sintaks dan penggunaan parameter penjadwalan, lihat Mengonfigurasi dan menggunakan parameter penjadwalan dan Jenis node yang didukung.
Kelola parameter tingkat ruang kerja
Di tab Workspace-level Parameters, Anda dapat melihat, memodifikasi, membandingkan versi, dan menghapus parameter tingkat ruang kerja.
Izin peran:
| Action | Required role |
|---|---|
| Melihat detail parameter, task yang mereferensikannya, dan versi-versinya | Development, O&M, atau Workspace Administrator |
| Memodifikasi atau menghapus parameter | Hanya Workspace Administrator |
Untuk menambahkan Pengguna RAM ke ruang kerja dan menetapkan peran, lihat Menambahkan Pengguna RAM ke ruang kerja sebagai anggota dan menetapkan peran kepada anggota tersebut.
View
Klik parameter untuk melihat detailnya, ruang kerja tempat parameter tersebut berlaku, dan task-task yang mereferensikannya. Klik ID task untuk langsung membuka tab konfigurasi node tersebut.
Modify
Hanya pemilik, nilai, dan deskripsi parameter yang dapat dimodifikasi. Setiap modifikasi akan membuat versi baru. Perubahan berlaku dalam waktu 10 menit.
Memodifikasi parameter tingkat ruang kerja memengaruhi semua task yang mereferensikannya. Tinjau task yang bergantung sebelum melakukan perubahan.
Compare versions and roll back
Lihat riwayat versi lengkap parameter, bandingkan dua versi secara berdampingan, dan kembalikan ke versi sebelumnya jika diperlukan.
Delete
Menghapus parameter tingkat ruang kerja menyebabkan semua task yang mereferensikannya gagal. Penghapusan berlaku segera. Dalam waktu 10 menit setelah penghapusan, task yang mereferensikan mungkin masih dapat menyelesaikan nilai parameter tersebut. Parameter yang direferensikan oleh task aktif tidak dapat dihapus.