ApsaraMQ for RocketMQ memungkinkan Anda mengekspor data grup dari satu instance dan mengimpornya ke instance ApsaraMQ for RocketMQ lain. Fitur ini berguna saat mengganti atau mengkloning instance untuk membuat grup dengan informasi dasar yang sama seperti pada instance asli.
Informasi latar belakang
Fitur ekspor dan impor data grup dapat digunakan dalam skenario berikut:
Mengganti Instance
Jika instance ApsaraMQ for RocketMQ tidak lagi memenuhi kebutuhan bisnis Anda, Anda dapat membeli instance baru dan menggunakan fitur ini untuk mengekspor data grup dari instance lama serta mengimpornya ke instance baru. Dengan cara ini, grup pada instance lama akan otomatis dibuat di instance baru.
Mengkloning Instance
Fitur ini juga membantu jika Anda ingin menerapkan beberapa instance ApsaraMQ for RocketMQ dan memastikan bahwa grup yang sama tersedia di lingkungan pengembangan, pengujian, dan produksi. Anda cukup membuat grup terkait pada salah satu instance, mengekspor datanya, lalu mengimpornya ke instance lain untuk membuat grup serupa secara cepat.
Catatan penggunaan
Metadata grup dari instance ApsaraMQ for RocketMQ 4.x berbeda dengan versi 5.x. Perhatikan hal-hal berikut saat mengekspor dan mengimpor data grup:
Anda dapat langsung mengimpor data grup dari instance 5.x ke 4.x. Namun, hanya bidang tertentu dalam file yang diimpor yang akan berlaku. Untuk detail lebih lanjut, lihat Langkah 5 bagian "Impor Data Grup" topik Ekspor dan Impor Data Grup.
Anda tidak dapat langsung mengimpor data grup dari instance 4.x ke 5.x. Sebelum mengimpor, modifikasi parameter dalam file data grup sesuai deskripsi di Langkah 5 bagian "Impor Data Grup" topik ini.
Saat mengekspor dan mengimpor data grup, hanya informasi dasar seperti ID, kebijakan konsumsi, dan deskripsi grup yang diproses. Langganan dan data pesan tidak termasuk dalam proses ini.
Nilai parameter dalam file yang diimpor harus memenuhi persyaratan yang ditentukan di Langkah 5 bagian "Impor Data Grup" topik ini.
Ekspor data grup
Masuk ke Konsol ApsaraMQ for RocketMQ. Di panel navigasi kiri, klik Instances.
Di bilah navigasi atas, pilih wilayah, seperti China (Hangzhou). Pada halaman Instances, klik nama instance yang ingin dikelola.
Di panel navigasi kiri, klik Groups.
Di pojok kanan atas halaman Groups, klik ikon
.Sistem mengekspor data grup dari instance dan menyimpannya dalam file .xlsx.
Impor data grup
Anda dapat langsung mengimpor data grup yang diekspor ke instance tujuan atau memperbarui data tersebut sesuai kebutuhan bisnis sebelum melakukan impor.
Masuk ke Konsol ApsaraMQ for RocketMQ. Di panel navigasi kiri, klik Instances.
Di bilah navigasi atas, pilih wilayah, seperti China (Hangzhou). Pada halaman Instances, klik nama instance yang ingin dikelola.
Di panel navigasi kiri, klik Groups.
Di pojok kanan atas halaman Groups, klik ikon
.Pilih file data grup yang disimpan di mesin lokal Anda dan klik Open.
Tabel berikut menjelaskan persyaratan nilai parameter dalam file data grup yang ingin diimpor.
Parameter
Deskripsi
Nilai Valid
ConsumerGroupId
ID grup.
ID grup dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-).
ID grup harus memiliki panjang 1 hingga 60 karakter.
ID grup tidak boleh berisi karakter sistem cadangan atau awalan khusus. Untuk informasi lebih lanjut, lihat Batasan Parameter.
DeliveryOrderType
Urutan pengiriman pesan oleh ApsaraMQ for RocketMQ ke klien konsumen.
Nilai valid:
Concurrently: pengiriman bersamaan
Orderly: pengiriman terurut
Untuk informasi lebih lanjut, lihat Pesan Terurut.
ConsumeRetryPolicy
Kebijakan ulang yang digunakan saat konsumen gagal mengonsumsi pesan.
Nilai valid:
FixedRetryPolicy: pengulangan interval tetap
DefaultRetryPolicy: pengulangan eksponensial mundur
Untuk informasi lebih lanjut, lihat Pengulangan Konsumsi.
MaxRetryTimes
Jumlah maksimum percobaan ulang.
Atur parameter ini ke nilai yang kurang dari atau sama dengan 1000.
DeadLetterTargetTopic
Topik surat mati.
Topik dari mana pesan surat mati dikirim tidak dapat digunakan sebagai topik surat mati.
Jika Anda tidak ingin menggunakan fitur pesan surat mati, biarkan parameter ini kosong.
Untuk informasi lebih lanjut, lihat Pesan Surat Mati.
Remark
Deskripsi grup.
Deskripsi grup harus memiliki panjang 1 hingga 60 karakter.
Contoh:
ConsumerGroupId
DeliveryOrderType
ConsumeRetryPolicy
MaxRetryTimes
DeadLetterTargetTopic
Remark
testgroup1
Orderly
FixedRetryPolicy
16
Digunakan untuk berlangganan pesan tagihan.
testgroup2
Concurrently
DefaultRetryPolicy
16
targettopic1
Digunakan untuk berlangganan pesan logistik.
Di panel Import Resources, pilih grup yang datanya ingin diimpor dan klik Confirm and Import di kolom Actions.
Anda juga dapat memilih beberapa grup dan klik Batch Import.
Setelah mengimpor data grup, nilai di kolom Execution Results daftar grup berubah menjadi Imported.
Di pojok kiri bawah panel Import Resources, klik OK untuk menyelesaikan operasi impor.
Setelah data grup diimpor, grup yang datanya diimpor akan muncul di daftar grup.
Referensi
Untuk informasi tentang cara menyinkronkan data topik di seluruh instance, lihat Ekspor dan Impor Data Topik.
Untuk informasi tentang cara memigrasikan data dari kluster Apache RocketMQ mandiri ke instance ApsaraMQ for RocketMQ, lihat Migrasi Kluster Apache RocketMQ Mandiri ke Instance ApsaraMQ for RocketMQ.