DataWorks:Gunakan parameter tingkat ruang kerja

Latar Belakang

Parameter penjadwalan adalah variabel yang digunakan dalam penjadwalan task DataWorks. Berdasarkan aturan yang Anda konfigurasikan, DataWorks secara otomatis melakukan substitusi nilainya setiap kali task dijalankan. Untuk informasi selengkapnya tentang parameter penjadwalan, lihat Scheduling parameters.

Prasyarat

• Ruang kerja harus sudah ada. Untuk informasi selengkapnya tentang cara membuat ruang kerja, lihat Configure a workspace.

• Anda harus memiliki role Workspace Administrator di ruang kerja tersebut. Hanya anggota ruang kerja dengan role Workspace Administrator dan owner yang dapat membuat, mengubah, menghapus, atau mengembalikan parameter tingkat ruang kerja serta melihat nilai parameter rahasia. Untuk informasi selengkapnya, lihat Add workspace members and manage their roles.

• Diperlukan DataWorks Edisi Profesional atau lebih tinggi. Untuk informasi selengkapnya, lihat Purchase or upgrade a DataWorks edition.

Batasan

• Parameter tingkat ruang kerja hanya didukung saat Anda menggunakan resource group arsitektur tanpa server (serverless).

Peringatan

• Fitur ciphertext (penyembunyian) pada parameter tingkat ruang kerja menyediakan penyembunyian dasar untuk parameter sensitif. Penyembunyian ini hanya berlaku dalam kode dan log di dalam DataWorks dan bukan merupakan kemampuan keamanan global. Misalnya, fitur ini dapat dilewati ketika data diakses melalui compute engine lain. Fitur ini tidak dapat menggantikan Key Management Service (KMS).

• Untuk data yang sangat sensitif seperti kunci dan kredensial, gunakan KMS untuk manajemen terpusat. Jenis node DataWorks seperti PyODPS, Shell, Notebook, dan PAI DLC mendukung akses ke layanan cloud melalui role. Berikan izin yang diperlukan kepada runtime role agar dapat mengambil rahasia dari KMS secara dinamis selama eksekusi task, alih-alih menyimpannya dalam kode atau parameter tingkat ruang kerja.

Buat parameter tingkat ruang kerja

1. Buka halaman untuk membuat parameter tingkat ruang kerja.

   1. Login ke DataWorks console. Di Wilayah target, klik Data Development and O&M > Operation Center di panel navigasi sebelah kiri. Pilih ruang kerja dari daftar drop-down lalu klik Go to Operation Center.

   2. Di panel navigasi sebelah kiri Operation Center, klik Others > Scheduling Configuration, lalu klik tab Workspace-level Parameters.

2. Buat parameter tingkat ruang kerja.

   1. Di tab Workspace-level Parameters, klik Create Workspace-level Parameter dan konfigurasikan parameter tersebut.

      Catatan

      Untuk membuat beberapa parameter sekaligus, klik Batch Create Workspace-level Parameters.

      Parameter	Deskripsi
      Parameter Name	Tentukan nama kustom untuk parameter tersebut. Nama harus diawali dengan workspace. dan harus unik.
      Owner	Tentukan owner dari parameter tingkat ruang kerja tersebut. Catatan Workspace Administrator dapat menetapkan anggota ruang kerja mana pun sebagai owner parameter. Hanya Workspace Administrator yang dapat mengubah atau menghapus parameter tingkat ruang kerja. Jika Anda perlu melakukan operasi manajemen ini, Anda dapat menambahkan pengguna ke ruang kerja dan memberikan role yang sesuai. Untuk informasi selengkapnya, lihat Add workspace members and manage their roles.
      Applicable Workspace	Pilih ruang kerja tempat parameter ini akan digunakan. Setelah dikonfigurasi, semua task di ruang kerja tersebut dapat mereferensi parameter ini. Catatan Daftar hanya menampilkan ruang kerja tempat pengguna saat ini menjadi Workspace Administrator. Parameter tingkat ruang kerja hanya dapat digunakan di satu ruang kerja.
      Parameter Type dan Parameter Value	Menentukan nilai substitusi saat sebuah task dijalankan. Tipe berikut didukung: Constant (Plaintext): Nilai tetap yang terlihat oleh semua pengguna. Contoh: 123. Constant (Ciphertext): Nilai tetap yang disembunyikan (secara default ditampilkan sebagai ******). Gunakan tipe ini untuk data sensitif. Misalnya, jika Anda memasukkan 123, nilainya akan ditampilkan sebagai ******. Variable: Nilai yang dihasilkan secara dinamis berdasarkan variabel sistem. Misalnya, Anda dapat menetapkan nilai ke $[yyyy-mm-dd] untuk mendapatkan waktu penjadwalan task, atau ke ${yyyy-mm-dd} untuk mendapatkan waktu data (data timestamp) saat task dijalankan. Untuk format yang didukung lainnya, lihat Supported formats for scheduling parameters. Catatan Parameter Value dapat diatur ke beberapa karakter khusus. Untuk detailnya, lihat prompt pada UI. Anda tidak dapat mereferensi parameter tingkat ruang kerja lain dalam nilai suatu parameter. Pada ruang kerja mode standar, Anda dapat mengonfigurasi nilai berbeda untuk parameter yang sama di lingkungan pengembangan dan lingkungan produksi. Untuk informasi selengkapnya tentang mode ruang kerja, lihat Differences between workspace modes.

   2. Klik OK untuk membuat parameter tersebut.

Gunakan parameter tingkat ruang kerja

Setelah membuat parameter tingkat ruang kerja, referensikan parameter tersebut di node mana pun dalam ruang kerja yang berwenang. Penggunaannya sama seperti parameter penjadwalan standar:

1. Definisikan variabel dalam kode node.

2. Di halaman konfigurasi node, buka bagian Scheduling > Scheduling Parameters dan tetapkan parameter tingkat ruang kerja ke variabel tersebut.

Setelah dikonfigurasi, pratinjau nilai parameter untuk memverifikasi output dan sesuaikan jika diperlukan. Untuk informasi selengkapnya tentang penggunaan parameter penjadwalan, lihat Configure and use scheduling parameters.

Di bidang input nilai Scheduling Parameters, klik untuk membuka popover, beralih ke tab Workspace Parameters, lalu pilih parameter tingkat ruang kerja yang diinginkan (misalnya ${workspace.test}) untuk menyelesaikan pemberian nilai.

Atur parameter tingkat ruang kerja

Di halaman Workspace-level Parameters, Anda dapat melakukan operasi berikut:

• Lihat parameter: Lihat detail parameter, ruang kerja terkait, dan task yang mereferensikannya. Anda dapat menavigasi ke task berdasarkan ID-nya untuk melakukan operasi pengembangan.

• Mengubah parameter:

  • Anda hanya dapat mengubah owner, nilai, dan deskripsi parameter. Setiap perubahan membuat versi baru.

  • Jika parameter direferensikan oleh task, perubahan tersebut akan memengaruhi task tersebut. Lakukan dengan hati-hati.

  • Perubahan berlaku dalam waktu 10 menit.

• Bandingkan dan kembalikan versi: Anda dapat melihat riwayat versi parameter, membandingkan versi, dan mengembalikan ke versi sebelumnya.

• Hapus parameter:

  • Anda tidak dapat menghapus parameter jika direferensikan oleh task lain.

  • Menghapus parameter menyebabkan task terkait gagal. Lakukan dengan hati-hati.

  • Meskipun penghapusan langsung berlaku di halaman Workspace-level Parameters, task yang mereferensikan parameter tersebut mungkin masih mengambil nilainya saat runtime hingga 10 menit.