DataWorks：Gunakan parameter tingkat workspace

Informasi latar belakang

Di DataWorks, suatu tugas dijadwalkan untuk dijalankan berdasarkan parameter penjadwalan yang dikonfigurasikan untuk tugas tersebut. Nilai dari parameter penjadwalan akan diganti secara otomatis sesuai aturan penugasan nilai setiap kali tugas dijalankan. Untuk informasi lebih lanjut, lihat Format yang Didukung untuk Parameter Penjadwalan.

Prasyarat

• Sebuah workspace telah dibuat. Parameter tingkat workspace harus digunakan dalam workspace tertentu. Untuk informasi tentang cara membuat workspace, lihat Kelola Workspace.

• Seorang pengguna telah ditambahkan ke workspace sebagai anggota dan diberi peran Workspace Administrator. Hanya pengguna dengan peran Workspace Administrator yang dapat membuat parameter tingkat workspace. Untuk informasi tentang cara menambahkan pengguna ke workspace sebagai anggota dan menetapkan peran kepada pengguna, lihat Tambahkan Pengguna RAM ke Workspace sebagai Anggota dan Tetapkan Peran kepada Anggota.

• DataWorks Edisi Profesional atau edisi yang lebih canggih telah diaktifkan. Parameter tingkat workspace hanya tersedia di DataWorks Edisi Profesional atau edisi yang lebih canggih. Untuk informasi lebih lanjut, lihat Perbedaan antara Edisi DataWorks.

Batasan

• Hanya grup sumber daya eksklusif untuk penjadwalan yang mendukung fitur ini. Grup sumber daya bersama untuk penjadwalan tidak mendukung fitur ini.

• Jika grup sumber daya eksklusif untuk penjadwalan yang ingin Anda gunakan dibuat setelah 1 Januari 2024, Anda dapat menggunakan parameter tingkat workspace seperti yang diharapkan. Jika grup sumber daya eksklusif untuk penjadwalan yang ingin Anda gunakan dibuat sebelum 1 Januari 2024, Anda harus menghubungi dukungan teknis untuk meningkatkan konfigurasi grup sumber daya sebelum dapat menggunakan parameter tingkat workspace.

Buat parameter tingkat workspace

1. Akses titik masuk untuk membuat parameter tingkat workspace.

   1. Buka halaman Operation Center.

      Masuk ke Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Di panel navigasi kiri, pilih Data Development and O&M > Operation Center. Pada halaman yang muncul, pilih workspace yang diinginkan dari daftar drop-down dan klik Go to Operation Center.

   2. Di panel navigasi kiri halaman Operation Center, pilih Other > Tenant Schedule Setting. Pada halaman yang muncul, klik tab Workspace-level Parameters.

2. Buat parameter tingkat workspace.

   1. Di tab Parameter Tingkat Workspace, klik Create Workspace-level Parameter. Di kotak dialog Buat Parameter Tingkat Workspace, konfigurasikan parameter sesuai kebutuhan bisnis Anda.

      Catatan

      Untuk membuat beberapa parameter tingkat workspace sekaligus, Anda dapat mengklik Batch Create Workspace-level Parameters.

      Parameter	Deskripsi
      Parameter Name	Nama dari parameter tingkat workspace. Secara default, nama tersebut memiliki awalan workspace.. Nama parameter harus unik.
      Owner	Menentukan pemilik dari parameter tingkat workspace. Catatan workspace administrator dapat menentukan anggota mana pun di workspace sebagai pemilik parameter tingkat workspace. Hanya workspace administrator yang dapat memodifikasi atau menghapus semua parameter tingkat workspace. Jika Anda ingin mengelola parameter tingkat workspace sebagai pengguna RAM, Anda dapat menambahkan pengguna RAM ke workspace sebagai anggota dan menetapkan peran yang diperlukan kepada pengguna RAM. Untuk informasi lebih lanjut, lihat Tambahkan pengguna RAM ke workspace sebagai anggota dan tetapkan peran kepada anggota.
      Workspace	Menentukan workspace di mana parameter tingkat workspace dapat digunakan. Setelah Anda mengonfigurasi parameter ini, semua tugas di workspace yang ditentukan dapat menggunakan parameter tingkat workspace. Catatan Hanya workspace yang administrator workspacenya adalah akun login saat ini yang ditampilkan di daftar drop-down. Setiap parameter tingkat workspace hanya dapat digunakan di satu workspace.
      Parameter Type, Parameter Value (Development Environment), and Parameter Value (Production Environment)	Tentukan nilai aktual dari parameter tingkat workspace yang digunakan dalam tugas selanjutnya. Nilai yang valid: Konstanta (Teks Biasa): Parameter tingkat workspace diberi nilai konstan yang terlihat oleh semua pengguna. Contoh: 123. Konstanta (Ciphertext): Secara default, parameter tingkat workspace diberi nilai konstan yang disembunyikan sebagai ******. Jika data Anda sensitif, Anda dapat menetapkan parameter Tipe Parameter ke Konstanta (Ciphertext). Sebagai contoh, jika Anda memasukkan 123, nilainya akan ditampilkan sebagai ******. Variabel: Nilai dari parameter tingkat workspace diganti secara dinamis dengan nilai spesifik berdasarkan variabel yang Anda konfigurasikan. Sebagai contoh, Anda dapat menentukan nilai dalam format $[yyyy-mm-dd], yang menunjukkan waktu ketika suatu tugas dijadwalkan untuk dijalankan. Anda juga dapat menentukan nilai dalam format ${yyyy-mm-dd}, yang menunjukkan timestamp data dari tugas tersebut. Untuk informasi lebih lanjut tentang format yang didukung, lihat Format yang didukung untuk parameter penjadwalan. Catatan parameter value dapat berisi karakter khusus tertentu. Anda dapat melihat karakter khusus yang didukung di Konsol DataWorks. Anda tidak dapat mereferensikan parameter tingkat workspace lainnya saat memberikan nilai ke parameter tingkat workspace saat ini. Jika Anda menggunakan workspace dalam mode standar, Anda dapat menentukan nilai berbeda untuk parameter tingkat workspace yang sama di lingkungan pengembangan dan produksi berdasarkan kebutuhan bisnis Anda. Untuk informasi tentang mode workspace, lihat Perbedaan antara workspace dalam mode dasar dan workspace dalam mode standar.

   2. Klik OK.

Gunakan parameter tingkat workspace

Setelah membuat parameter tingkat workspace, akses workspace tempat parameter tersebut diterapkan dan gunakan parameter tingkat workspace pada tab konfigurasi node tertentu. Parameter tingkat workspace dapat digunakan seperti parameter penjadwalan.

1. Definisikan variabel dalam kode node yang diinginkan.

2. Buka tab konfigurasi node. Di panel navigasi kanan, klik Properties. Di bagian Scheduling Parameter, tetapkan parameter tingkat workspace ke variabel.

Setelah mengonfigurasi parameter tingkat workspace, Anda dapat melihat pratinjau apakah nilai parameter sesuai dengan harapan Anda dan menyesuaikan nilai berdasarkan kebutuhan bisnis Anda. Untuk informasi tentang cara menggunakan parameter penjadwalan, lihat Konfigurasikan dan Gunakan Parameter Penjadwalan.

Kelola parameter tingkat workspace

Di tab Workspace-level Parameters, Anda dapat melakukan operasi berikut pada parameter tingkat workspace.

• Lihat Parameter Tingkat Workspace: Anda dapat melihat detail parameter tingkat workspace, workspace tempat parameter tersebut diterapkan, dan tugas-tugas yang mereferensikan parameter tingkat workspace. Klik ID tugas untuk membuka tab konfigurasi node yang sesuai dan lakukan operasi pengembangan.

• Modifikasi Parameter Tingkat Workspace:

  • Anda hanya dapat memodifikasi pemilik, nilai, dan deskripsi dari parameter tingkat workspace. Setiap modifikasi akan menghasilkan versi baru.

  • Jika Anda memodifikasi parameter tingkat workspace yang direferensikan oleh tugas lain, nilai parameter tingkat workspace pada tugas tersebut akan terpengaruh. Berhati-hatilah saat memodifikasi parameter tingkat workspace.

  • Modifikasi berlaku dalam 10 menit.

• Bandingkan Versi Parameter dan Rollback Parameter: Anda dapat melihat versi historis dari parameter tingkat workspace, membandingkan versi parameter tingkat workspace, dan rollback parameter tingkat workspace ke versi tertentu.

• Hapus Parameter Tingkat Workspace:

  • Jika parameter tingkat workspace direferensikan oleh tugas lain, Anda tidak dapat menghapus parameter tersebut.

  • Jika Anda menghapus parameter tingkat workspace, tugas-tugas yang mereferensikan parameter tersebut gagal dijalankan. Berhati-hatilah saat menghapus parameter tingkat workspace.

  • Operasi penghapusan berlaku segera. Setelah menghapus parameter tingkat workspace, Anda tidak dapat menemukan parameter tersebut di tab Parameter Tingkat Workspace. Dalam waktu 10 menit setelah parameter tingkat workspace dihapus, tugas-tugas yang mereferensikan parameter tersebut mungkin masih dapat memperoleh nilai dari parameter tersebut.