Ao substituir uma instância do ApsaraMQ for RocketMQ ou replicar configurações entre ambientes, recriar grupos de consumidores manualmente consome tempo e aumenta o risco de erros. O recurso de exportação e importação de dados de grupos permite exportar as configurações de grupos de uma instância como um arquivo .xlsx e importá-las em outra, recriando automaticamente todos os grupos com as mesmas definições.
Apenas os metadados dos grupos são exportados: IDs dos grupos, tipos de ordem de entrega, políticas de nova tentativa e descrições. Assinaturas e dados de mensagens não são exportados nem alterados.
Casos de uso
Substituição de instância: Exporte os dados de grupos da instância original e importe-os na nova instância. Todos os grupos serão recriados automaticamente.
Clonagem de ambiente: Replique configurações de grupos entre instâncias de desenvolvimento, teste e produção em uma única operação de importação.
Compatibilidade entre versões
Os metadados de grupos diferem entre instâncias do ApsaraMQ for RocketMQ 4.x e 5.x:
|
Caminho de migração |
Ação necessária |
|
5.x para 4.x |
Importe diretamente. Apenas campos específicos terão efeito na instância 4.x. |
|
4.x para 5.x |
Antes de importar, atualize os parâmetros no arquivo de dados para corresponder ao formato 5.x. Consulte Requisitos de parâmetros. |
Exportar dados de grupos
Faça login no console do ApsaraMQ for RocketMQ. No painel de navegação à esquerda, clique em Instances.
Na barra de navegação superior, selecione uma região, como China (Hangzhou). Na página Instances, clique em nome da instância que você deseja gerenciar.
No painel de navegação à esquerda, clique em Groups.
No canto superior direito da página Groups, clique em ícone
. Todos os dados de grupos da instância serão exportados e salvos como um arquivo .xlsx.
Importar dados de grupos
É possível importar o arquivo exportado diretamente ou editá-lo previamente para atualizar os grupos antes da importação.
Faça login no console do ApsaraMQ for RocketMQ. No painel de navegação à esquerda, clique em Instances.
Na barra de navegação superior, selecione uma região, como China (Hangzhou). Na página Instances, clique em nome da instância que você deseja gerenciar.
No painel de navegação à esquerda, clique em Groups.
No canto superior direito da página Groups, clique em ícone
.Selecione o arquivo de dados de grupos em sua máquina local e clique em Open.
No painel Import Resources, selecione os grupos a serem importados e clique em Confirm and Import na coluna Actions. Para importar vários grupos simultaneamente, selecione-os e clique em Batch Import. Após o processamento de cada grupo, a coluna Execution Results exibirá Imported.
No canto inferior esquerdo do painel Import Resources, clique em OK para concluir a importação. Os grupos importados passarão a aparecer na lista de grupos.
Requisitos de parâmetros
Cada linha do arquivo de importação deve atender aos seguintes requisitos.
|
Parâmetro |
Descrição |
Valores válidos |
|
ConsumerGroupId |
ID do grupo. Apenas letras, dígitos, sublinhados (_) e hifens (-). De 1 a 60 caracteres. Não pode conter caracteres reservados pelo sistema ou prefixos especiais. Consulte Limites de parâmetros. |
Letras, dígitos, sublinhados e hifens |
|
DeliveryOrderType |
Ordem de entrega de mensagens. Consulte Mensagens ordenadas. |
|
|
ConsumeRetryPolicy |
Política de nova tentativa para consumo de mensagens com falha. Consulte Nova tentativa de mensagem. |
|
|
MaxRetryTimes |
Número máximo de novas tentativas. |
Menor ou igual a 1.000 |
|
DeadLetterTargetTopic |
Tópico de destino para mensagens que excedem o limite de novas tentativas. Tópicos de source não podem servir como tópicos de mensagens mortas. Deixe em branco para desativar. Consulte Mensagens mortas. |
Um nome de tópico válido ou em branco |
|
Remark |
Descrição do grupo. |
De 1 a 60 caracteres |
Exemplo de arquivo de dados
|
ConsumerGroupId |
DeliveryOrderType |
ConsumeRetryPolicy |
MaxRetryTimes |
DeadLetterTargetTopic |
Remark |
|
testgroup1 |
Orderly |
FixedRetryPolicy |
16 |
Usado para assinar mensagens de faturamento. |
|
|
testgroup2 |
Concurrently |
DefaultRetryPolicy |
16 |
targettopic1 |
Usado para assinar mensagens de logística. |