Bir ApsaraMQ for RocketMQ örneğini değiştirdiğinizde veya yapılandırmaları ortamlar arasında kopyaladığınızda, tüketici gruplarını manuel olarak yeniden oluşturmak zaman alıcı ve hataya açıktır. Grup verilerini dışa ve içe aktarma özelliği, grup yapılandırmalarını bir örnekten .xlsx dosyası olarak dışa aktarmanıza ve başka bir örneğe aktarmanıza olanak tanır; bu sayede tüm gruplar aynı ayarlarla otomatik olarak yeniden oluşturulur.
Yalnızca grup meta verileri dışa aktarılır: grup kimlikleri, teslim sırası türleri, yeniden deneme ilkeleri ve açıklamalar. Abonelikler ve mesaj verileri dışa aktarılmaz veya değiştirilmez.
Kullanım senaryoları
Örnek değişimi: Orijinal örnekten grup verilerini dışa aktarın ve yeni bir örneğe aktarın. Tüm gruplar otomatik olarak yeniden oluşturulur.
Ortam klonlama: Geliştirme, test ve üretim ortamlarındaki örneklerde grup yapılandırmalarını tek bir içe aktarma işlemiyle çoğaltın.
Sürümler arası uyumluluk
ApsaraMQ for RocketMQ 4.x ve 5.x örnekleri arasında grup meta verileri farklılık gösterir:
| Geçiş yolu | Gerekli işlem |
|---|---|
| 5.x'ten 4.x'e | Doğrudan içe aktarın. Yalnızca belirli alanlar 4.x örneğinde geçerli olur. |
| 4.x'ten 5.x'e | İçe aktarmadan önce, veri dosyasındaki parametreleri 5.x formatına uygun şekilde güncelleyin. Bkz. Parametre gereksinimleri. |
Grup verilerini dışa aktarma
ApsaraMQ for RocketMQ konsolu adresinde oturum açın. Sol gezinme bölmesinde Instances seçeneğine tıklayın.
Üst gezinme çubuğunda China (Hangzhou) gibi bir bölge seçin. Instances sayfasında yönetmek istediğiniz örneğin adına tıklayın.
Sol gezinme bölmesinde Groups seçeneğine tıklayın.
Groups sayfasının sağ üst köşesindeki
simgesine tıklayın. Örnekteki tüm grup verileri dışa aktarılır ve .xlsx dosyası olarak kaydedilir.
Grup verilerini içe aktarma
Dışa aktarılan dosyayı doğrudan içe aktarabilir veya içe aktarmadan önce grupları güncellemek için dosyayı düzenleyebilirsiniz.
ApsaraMQ for RocketMQ konsolu adresinde oturum açın. Sol gezinme bölmesinde Instances seçeneğine tıklayın.
Üst gezinme çubuğunda China (Hangzhou) gibi bir bölge seçin. Instances sayfasında yönetmek istediğiniz örneğin adına tıklayın.
Sol gezinme bölmesinde Groups seçeneğine tıklayın.
Groups sayfasının sağ üst köşesindeki
simgesine tıklayın.Yerel makinenizden grup veri dosyasını seçin ve Open öğesine tıklayın.
Import Resources panelinde içe aktarmak istediğiniz grupları seçin ve Actions sütunundaki Confirm and Import seçeneğine tıklayın. Birden fazla grubu aynı anda içe aktarmak için grupları seçip Batch Import seçeneğine tıklayın. Her grup işlendikten sonra Execution Results sütunu Imported durumunu gösterir.
Import Resources panelinin sol alt köşesindeki Complete seçeneğine tıklayarak içe aktarma işlemini tamamlayın. İçe aktarılan gruplar artık grup listesinde görünür.
Parametre gereksinimleri
İçe aktarma dosyasındaki her satır aşağıdaki gereksinimleri karşılamalıdır.
| Parametre | Açıklama | Geçerli değerler |
|---|---|---|
| ConsumerGroupId | Grup kimliği. Yalnızca harfler, rakamlar, alt çizgiler (_) ve tireler (-) kullanılabilir. 1 ila 60 karakter uzunluğunda olmalıdır. Sistem tarafından ayrılmış karakterleri veya özel ön ekleri içeremez. Bkz. Parametre sınırlamaları. | Harfler, rakamlar, alt çizgiler ve tireler |
| DeliveryOrderType | Mesaj teslim sırası. Bkz. Sıralı mesajlar. | Concurrently (eşzamanlı teslimat) veya Orderly (sıralı teslimat) |
| ConsumeRetryPolicy | Başarısız mesaj tüketimi için yeniden deneme ilkesi. Bkz. Mesaj yeniden denemesi. | FixedRetryPolicy (sabit aralıklı yeniden deneme) veya DefaultRetryPolicy (üstel geri çekilmeli yeniden deneme) |
| MaxRetryTimes | Maksimum yeniden deneme sayısı. | 1.000'e eşit veya daha az |
| DeadLetterTargetTopic | Yeniden deneme sınırını aşan mesajlar için hedef konu. Kaynak konular dead-letter konusu olarak kullanılamaz. Devre dışı bırakmak için boş bırakın. Bkz. Dead-letter mesajlar. | Geçerli bir konu adı veya boş |
| Remark | Grup açıklaması. | 1 ila 60 karakter |
Örnek veri dosyası
| ConsumerGroupId | DeliveryOrderType | ConsumeRetryPolicy | MaxRetryTimes | DeadLetterTargetTopic | Remark |
|---|---|---|---|---|---|
| testgroup1 | Orderly | FixedRetryPolicy | 16 | Faturalandırma mesajlarına abone olmak için kullanılır. | |
| testgroup2 | Concurrently | DefaultRetryPolicy | 16 | targettopic1 | Lojistik mesajlarına abone olmak için kullanılır. |