All Products
Search
Document Center

Realtime Compute for Apache Flink:Klon namespace

Last Updated:Apr 25, 2026

Fitur klon namespace memungkinkan Anda menyalin entitas dan konfigurasi dari namespace sumber ke namespace target dalam wilayah yang sama secara cepat. Fitur ini mengurangi pekerjaan pengembangan berulang, meningkatkan pemanfaatan resource, serta menyediakan cadangan dingin untuk pemulihan bencana. Topik ini mencakup kasus penggunaan, prosedur, dan pertimbangan penting saat melakukan klon namespace.

Kasus penggunaan

Kategori

Kasus penggunaan

Rekomendasi

Cadangan data

  • Lakukan backup data kritis secara berkala untuk mencegah kehilangan data akibat kegagalan sistem.

  • Buat snapshot data independen pada berbagai tahap proyek guna mendukung pelacakan atau rollback.

  • Gunakan namespace target kosong: Klon data namespace sumber ke namespace baru yang kosong. Hal ini menjamin independensi backup dan mencegah konflik dengan data yang sudah ada.

  • Full backup: Setiap klon merupakan cadangan penuh data. Anda tidak perlu memfilter data inkremental secara manual karena sistem secara otomatis menangkap kondisi data lengkap terbaru.

  • Manajemen versi: Anda dapat menerapkan kontrol versi dengan mudah melalui penamaan namespace target menggunakan tanggal atau nomor versi. Misalnya, Backup_20241001 dan Backup_20241015 dapat merepresentasikan backup dari waktu berbeda, sehingga mempermudah kueri dan pemulihan data di kemudian hari.

Kloning dan berbagi resource

  • Penggunaan ulang resource: Jika sebuah namespace berisi banyak resource yang sudah ada, gunakan fitur klon untuk menyalinnya dengan cepat ke lingkungan baru dan hindari pengaturan berulang.

  • Kolaborasi lintas tim: Saat beberapa tim perlu berbagi resource yang sama, klon resource tersebut ke namespace terpisah untuk masing-masing tim.

  • Isolasi lingkungan: Untuk pengujian, pengembangan, atau produksi, kloning dapat membuat salinan resource terisolasi guna memastikan konsistensi dan pemisahan antarlingkungan.

  • Namespace target dengan data yang sudah ada: Berbeda dengan backup data, dalam skenario berbagi resource, namespace target biasanya sudah berisi resource lain. Kloning mengintegrasikan data sumber ke dalam struktur resource yang sudah ada.

  • Manajemen izin: Selama proses kloning, kami merekomendasikan penggunaan kontrol izin yang tepat untuk memastikan hanya pengguna yang berwenang yang dapat mengakses dan mengelola resource di namespace target.

Migrasi penyimpanan dan data

  • Migrasi dari OSS yang dikelola sendiri ke layanan yang sepenuhnya dikelola.

  • Migrasi data dari namespace pengujian ke namespace produksi.

Izin penyimpanan: Untuk melakukan klon dari penyimpanan OSS ke penyimpanan yang sepenuhnya dikelola, Anda harus memberikan izin read-only (termasuk aksi ListObject) pada bucket yang terkait dengan namespace kepada akun yang sepenuhnya dikelola arn:sts::1060219998962774:assumed-role/aliyunstreamasidefaultrole/refresh_token. Untuk informasi lebih lanjut, lihat Set a bucket policy.

Batasan

  • Batasan wilayah: Kloning hanya didukung untuk namespace dalam wilayah yang sama. Operasi lintas-wilayah tidak didukung.

  • Cakupan kloning: Anda hanya dapat mengklon namespace, bukan seluruh ruang kerja.

  • Konten yang tidak disertakan: Orkestrasi task, antrian, izin, dan konfigurasi notifikasi tidak diklon.

  • Kebijakan versi: Hanya draft terbaru dari lingkungan pengembangan dan deployment dari lingkungan operasional yang diklon. Versi historis draft diabaikan.

  • Operasi konkuren: Anda tidak dapat mengklon satu namespace sumber ke beberapa target, atau beberapa namespace sumber ke satu target, secara bersamaan.

  • Kompatibilitas penyimpanan: Jika ruang kerja sumber menggunakan penyimpanan yang sepenuhnya dikelola, ruang kerja target juga harus demikian. Anda tidak dapat memilih ruang kerja yang menggunakan OSS sebagai target.

  • Kompatibilitas arsitektur: Kloning hanya didukung antara namespace dengan arsitektur yang sama. Kloning lintas-arsitektur antara x86 dan ARM tidak didukung.

  • Kloning berstatus: Kloning dengan status (checkpoint atau savepoint) hanya didukung untuk versi engine VVR 6.0.2 dan yang lebih baru.

Pertimbangan

Izin
Untuk memulai klon, Anda harus memiliki peran Editor untuk namespace sumber maupun target. Sistem menggunakan identitas pengguna ini untuk autentikasi end-to-end. Untuk informasi lebih lanjut, lihat Authorize users in the development console.

Batasan kloning

  • Penguncian resource: Anda tidak dapat mengubah konfigurasi resource selama proses kloning.

  • Operasi tidak dapat dibatalkan: Operasi klon tidak dapat diurungkan. Jika Anda menghentikan proses, Anda harus menghapus secara manual resource yang telah diklon sebelumnya.

  • Hindari duplikasi: Melakukan klon ke namespace target yang sama beberapa kali akan menghasilkan resource duplikat.

  • Izin penyimpanan: Untuk melakukan klon dari penyimpanan OSS ke penyimpanan yang sepenuhnya dikelola, Anda harus memberikan izin read-only (termasuk aksi ListObject) pada bucket yang terkait dengan namespace kepada akun yang sepenuhnya dikelola arn:sts::1060219998962774:assumed-role/aliyunstreamasidefaultrole/refresh_token. Untuk informasi lebih lanjut, lihat Set a bucket policy.

Status job yang diklon

Saat Anda memilih untuk mengklon dengan status:

  • Untuk job streaming yang telah selesai atau dihentikan, sistem mengklon snapshot terbaru atau system checkpoint.

  • Untuk job streaming yang sedang berjalan atau dalam transisi, jika Anda memilih kebijakan Do not skip, sistem secara otomatis membuat snapshot sebelum kloning. Namun, karena job terus berjalan, sistem mungkin menghasilkan system checkpoint yang lebih baru, sehingga snapshot yang diklon tidak dijamin merupakan status terbaru.

Periksa status job streaming

  • Dalam skenario migrasi, hentikan job sumber sebelum kloning untuk mencegah inkonsistensi data akibat status baru yang dihasilkan.

  • Menjalankan job sumber dan salinan hasil klon secara bersamaan dapat mengganggu logika bisnis Anda. Pastikan tidak ada dampak sebelum menjalankan job hasil klon.

  • System checkpoint yang berhasil menunjukkan bahwa job hasil klon berfungsi dengan benar. Pantau statusnya secara ketat.

Penanganan konflik penamaan
Sistem secara otomatis mengganti nama entitas di namespace target yang memiliki nama sama dengan entitas yang diklon. Anda dapat melihat daftar item yang diganti namanya di halaman Details riwayat kloning.

Perbarui konfigurasi secara manual
Nama katalog yang dikonfigurasi atau dirujuk dalam job tidak diperbarui secara otomatis. Anda harus memodifikasinya secara manual dalam kode dan konfigurasi job untuk mencegah kegagalan.

Debug job
Setelah kloning selesai, semua job yang diklon dan session cluster berada dalam status berhenti. Job hasil klon mungkin tidak berjalan dengan benar tanpa penyesuaian, misalnya jika konfigurasi dependensi tidak tersedia. Anda dapat melakukan tindakan berikut:

  1. Debug draft job.

  2. Periksa apakah file dependensi sesuai harapan.

  3. Atur ulang konfigurasi dependensi job.

Prosedur

  1. Siapkan namespace sumber, ruang kerja target, dan namespace target. Untuk informasi lebih lanjut, lihat Activate Realtime Compute for Apache Flink atau Manage namespaces.

  2. Klon entitas dan informasi konfigurasi namespace.

    1. Masuk ke Realtime Compute for Apache Flink console.

    2. Pada kolom More untuk ruang kerja yang berisi namespace sumber, pilih Space Cloning > Start cloning.

    3. Konfigurasikan pengaturan kloning.

      1. Pilih namespace sumber dan target.

      2. Pilih objek yang akan diklon.

        Anda dapat memilih objek yang perlu diklon sesuai kebutuhan, seperti draft, deployment, file resource, katalog kustom, UDF, konektor, format data, dan konfigurasi variabel.

        Saat Anda mengklon deployment, semua job dalam namespace saat ini dipilih secara default. Anda dapat memfilter daftar untuk memilih job tertentu. Filter didukung berdasarkan nama job, jenis job, versi engine, status run, dan waktu penyelesaian klon terakhir.

      3. Konfigurasikan kebijakan kloning.

        Konfigurasi

        Opsi

        Deskripsi

        Streaming job state cloning policy

        With state

        Mengklon snapshot terbaru atau system checkpoint untuk mencegah pemrosesan ulang data yang telah diproses.

        Stateless

        Hanya mengklon konfigurasi dan kode job, tanpa snapshot atau system checkpoint apa pun.

        Running streaming job cloning policy

        Skip

        Melewatkan job streaming yang sedang berjalan untuk mencegah gangguan data akibat status baru yang dihasilkan oleh job sumber. Direkomendasikan untuk migrasi.

        Do not skip

        Membuat snapshot job streaming yang sedang berjalan sebelum kloning untuk memastikan status terbaru ditangkap. Direkomendasikan untuk backup.

        Error handling policy

        Skip and continue

        Jika suatu entitas gagal diklon, kegagalan tersebut dicatat dan proses dilanjutkan untuk entitas yang tersisa.

        Stop cloning

        Jika ada entitas yang gagal diklon, seluruh tugas kloning segera dihentikan. Data yang berhasil diklon tetap dipertahankan.

        Allow stateless cloning

        Jika kloning dengan status gagal, proses secara otomatis beralih ke kloning stateless dan dilanjutkan.

    4. Klik Start cloning.

  3. Lihat progres dan hasil kloning.

    • Saat kloning berlangsung

      Tak lama setelah Anda mengklik Start cloning, notifikasi akan muncul. Klik View cloning progress untuk memantau tugas, yang dapat dijalankan di latar belakang.

      image

    • Setelah kloning selesai

      Pada kolom More untuk ruang kerja target, pilih Space Cloning > History of cloning, lalu klik Details. Anda dapat melihat kategori, jumlah total, dan jumlah kegagalan entitas yang diklon. Daftar entitas yang diganti namanya juga ditampilkan.

Dokumentasi terkait

Untuk mempelajari cara melakukan backup job SQL dan DataStream, lihat Back up and deploy a job.