Saat melakukan migrasi dari satu instans ApsaraMQ for RocketMQ ke instans lain atau mempertahankan konfigurasi topik yang identik di lingkungan pengembangan, pengujian, dan produksi, membuat ulang topik secara manual bersifat membosankan dan rentan kesalahan. Fitur ekspor dan impor data topik memungkinkan Anda mengekspor metadata topik dari instans sumber sebagai file .xlsx dan mengimpornya ke instans tujuan untuk membuat ulang topik secara otomatis.
Ekspor dan impor hanya memindahkan metadata topik—nama, jenis pesan, dan deskripsi. Pesan yang tersimpan dalam topik tidak terpengaruh atau dipindahkan. Ekspor dan impor lintas versi didukung; misalnya, Anda dapat mengekspor dari instans versi 4.x dan mengimpornya ke instans versi 5.x.
Kasus penggunaan
Instance migration: Ekspor data topik dari instans ApsaraMQ for RocketMQ 4.x dan impor ke instans 5.x. Semua topik akan dibuat ulang secara otomatis pada instans baru.
Environment cloning: Definisikan topik sekali, lalu ekspor dan impor ke berbagai instans pengembangan, pengujian, dan produksi agar konfigurasi tetap selaras.
Prasyarat
Sebelum memulai, pastikan Anda telah memiliki:
Instans ApsaraMQ for RocketMQ dengan topik yang sudah ada (sumber)
Instans ApsaraMQ for RocketMQ untuk menerima topik tersebut (tujuan)
Akses ke ApsaraMQ for RocketMQ console
Ekspor data topik
Login ke ApsaraMQ for RocketMQ console. Di panel navigasi kiri, klik Instances.
Di bilah navigasi atas, pilih wilayah, misalnya China (Hangzhou). Pada halaman Instances, klik nama instans sumber.
Di panel navigasi kiri, klik Topics.
Di pojok kanan atas halaman Topics, klik ikon
.
Data topik disimpan ke file .xlsx di perangkat lokal Anda.
Impor data topik
Impor langsung file .xlsx yang telah diekspor, atau perbarui sesuai kebutuhan bisnis sebelum mengimpor.
Persyaratan format file
File .xlsx harus berisi kolom-kolom berikut:
| Parameter | Description | Valid values |
|---|---|---|
| TopicName | Nama topik. | Huruf, angka, garis bawah (_), dan tanda hubung (-). Harus terdiri dari 1 hingga 60 karakter. Tidak boleh mengandung string sistem tereservasi atau awalan khusus. Untuk detail selengkapnya, lihat Limits on parameters. |
| MessageType | Jenis pesan dari topik. | TRANSACTION: Pesan transaksional. DELAY: Pesan terjadwal atau tertunda. FIFO: pesan terurut. NORMAL: pesan normal. |
| Remark | Deskripsi topik. | 1 hingga 60 karakter. |
Contoh:
| TopicName | MessageType | Remark |
|---|---|---|
| Topic1 | TRANSACTION | Digunakan untuk mengirim pesan transaksional. |
| Topic2 | NORMAL | Digunakan untuk mengirim pesan normal. |
| Topic3 | DELAY | Digunakan untuk mengirim pesan tertunda. |
Langkah-langkah impor
Login ke ApsaraMQ for RocketMQ console. Di panel navigasi kiri, klik Instances.
Di bilah navigasi atas, pilih wilayah, misalnya China (Hangzhou). Pada halaman Instances, klik nama instans tujuan.
Di panel navigasi kiri, klik Topics.
Di pojok kanan atas halaman Topics, klik ikon
.Pilih file .xlsx dan klik Open.
Pada panel Import Resources, pilih topik yang akan diimpor lalu klik Confirm and Import di kolom Actions. Untuk mengimpor beberapa topik sekaligus, pilih topik tersebut lalu klik Batch Import.
Setelah kolom Execution Results menampilkan status Imported untuk setiap topik, klik OK di pojok kiri bawah panel Import Resources.
Topik yang diimpor kini muncul dalam daftar topik pada instans tujuan.