ApsaraMQ for RocketMQ memungkinkan Anda mengekspor data grup dari satu instans dan mengimpornya ke instans ApsaraMQ for RocketMQ lain. Saat mengganti atau mengkloning instans, Anda dapat menggunakan fitur ini untuk membuat grup dengan informasi dasar yang sama seperti pada instans asli.
Informasi latar belakang
Fitur ekspor dan impor data grup dapat digunakan dalam skenario berikut:
Mengganti Instans
Jika instans ApsaraMQ for RocketMQ tidak lagi memenuhi kebutuhan bisnis Anda, Anda dapat membeli instans baru dan menggunakan fitur ini untuk mengekspor data grup dari instans lama dan mengimpornya ke instans baru. Dengan cara ini, grup dari instans lama akan otomatis dibuat pada instans baru.
Mengkloning Instans
Anda dapat menggunakan fitur ini saat menerapkan instans ApsaraMQ for RocketMQ berbeda untuk lingkungan pengembangan, uji, dan produksi. Dalam hal ini, buat grup terkait pada salah satu instans, ekspor data grup, lalu impor data tersebut ke instans lain untuk membuat grup serupa secara cepat.
Catatan penggunaan
Metadata grup dari instans ApsaraMQ for RocketMQ 4.x berbeda dari versi 5.x. Perhatikan hal-hal berikut saat mengekspor dan mengimpor data grup:
Anda dapat langsung mengimpor data grup dari instans ApsaraMQ for RocketMQ 5.x ke 4.x. Setelah impor, hanya bidang tertentu dalam file yang diimpor yang akan berlaku. Untuk detail lebih lanjut, lihat Langkah 5 bagian "Impor Data Grup".
Anda tidak dapat langsung mengimpor data grup dari instans ApsaraMQ for RocketMQ 4.x ke 5.x. Sebelum impor, modifikasi parameter dalam file data grup sesuai deskripsi di Langkah 5 bagian "Impor Data Grup".
Saat mengekspor dan mengimpor data grup, hanya informasi dasar seperti ID grup, kebijakan konsumsi, dan deskripsi grup yang diproses. Langganan dan data pesan tidak termasuk dalam proses ini.
Nilai parameter dalam file yang ingin diimpor harus memenuhi persyaratan yang ditentukan di Langkah 5 bagian "Impor Data Grup".
Ekspor data grup
Masuk ke Konsol ApsaraMQ for RocketMQ. Di bilah navigasi kiri, klik Instances.
Di bilah navigasi atas, pilih wilayah, seperti China (Hangzhou). Pada halaman Instans, klik nama instans yang ingin dikelola.
Di bilah navigasi kiri, klik Groups.
Di pojok kanan atas halaman Groups, klik ikon
.Sistem mengekspor data grup dari instans dan menyimpannya dalam file .xlsx.
Impor data grup
Anda dapat langsung mengimpor data grup yang diekspor ke instans tujuan atau memperbarui data grup sebelum impor sesuai kebutuhan bisnis. Ikuti langkah-langkah berikut untuk mengimpor data grup:
Masuk ke Konsol ApsaraMQ for RocketMQ. Di bilah navigasi kiri, klik Instances.
Di bilah navigasi atas, pilih wilayah, seperti China (Hangzhou). Pada halaman Instans, klik nama instans yang ingin dikelola.
Di bilah navigasi kiri, klik Groups.
Di pojok kanan atas halaman Groups, klik ikon
.Pilih file data grup dari mesin lokal Anda dan klik Open.
Tabel berikut menjelaskan persyaratan nilai parameter dalam file data grup yang akan diimpor.
Parameter
Deskripsi
Nilai valid
ConsumerGroupId
ID grup.
ID grup dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Kami merekomendasikan agar Anda memulai ID grup dengan "GID_" atau "GID-".
ID grup harus memiliki panjang 2 hingga 64 karakter.
ConsumerGroupType
Protokol yang digunakan oleh grup.
ApsaraMQ for RocketMQ memungkinkan Anda mengirim dan menerima pesan menggunakan klien HTTP dan TCP. Anda harus membuat grup yang berbeda untuk klien jenis yang berbeda. Misalnya, jika Anda ingin mengirim dan menerima pesan menggunakan SDK klien TCP, Anda harus membuat grup yang menggunakan protokol TCP.
Nilai valid:
TCP
HTTP
Remark
Deskripsi grup.
Deskripsi grup harus memiliki panjang 1 hingga 60 karakter.
Contoh:
ConsumerGroupId
ConsumerGroupType
Remark
GID_test1
HTTP
Digunakan untuk klien HTTP.
GID_test2
TCP
Digunakan untuk klien TCP.
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 bersangkutan akan muncul dalam daftar grup.
Referensi
Untuk informasi tentang cara menyinkronkan data topik di berbagai instans, lihat Ekspor dan Impor Data Topik.
Untuk informasi tentang cara memigrasikan data dari kluster Apache RocketMQ mandiri ke instans ApsaraMQ for RocketMQ, lihat Migrasikan Kluster Apache RocketMQ Mandiri ke Instans ApsaraMQ for RocketMQ.