Ao migrar de uma instância do ApsaraMQ for RocketMQ para outra ou manter configurações idênticas de tópicos nos ambientes de desenvolvimento, teste e produção, a recriação manual de tópicos torna-se repetitiva e sujeita a erros. O recurso de exportação e importação de dados de tópicos permite exportar os metadados de uma instância de source como um arquivo .xlsx e importá-los em uma instância de destino para recriar os tópicos automaticamente.
A exportação e a importação transferem apenas os metadados dos tópicos: nomes, tipos de mensagem e descrições. As mensagens armazenadas nos tópicos não são afetadas nem migradas. Há suporte para exportação e importação entre versões diferentes. Por exemplo, é possível exportar de uma instância 4.x e importar em uma instância 5.x.
Casos de uso
Migração de instância: exporte os dados de tópicos de uma instância do ApsaraMQ for RocketMQ 4.x e importe-os em uma instância 5.x. Todos os tópicos são recriados automaticamente na nova instância.
Clonagem de ambiente: defina os tópicos uma única vez e, em seguida, exporte-os e importe-os nas instâncias de desenvolvimento, teste e produção para manter as configurações sincronizadas.
Pré-requisitos
Antes de começar, verifique se você tem:
Uma instância do ApsaraMQ for RocketMQ com tópicos existentes (source)
Uma instância do ApsaraMQ for RocketMQ para receber os tópicos (destino)
Acesso ao console do ApsaraMQ for RocketMQ
Exportar dados de tópicos
Faça logon 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 no nome da instância de source.
No painel de navegação à esquerda, clique em Topics.
No canto superior direito da página Topics, clique em no ícone
.
Os dados dos tópicos são salvos em um arquivo .xlsx na sua máquina local.
Importar dados de tópicos
Importe o arquivo .xlsx exportado diretamente ou atualize-o conforme seus requisitos de negócio antes da importação.
Requisitos de formato de arquivo
O arquivo .xlsx deve conter as seguintes colunas:
|
Parâmetro |
Descrição |
Valores válidos |
|
TopicName |
Nome do tópico. |
Letras, dígitos, sublinhados (\_) e hifens (-). Deve ter de 1 a 60 caracteres. Não pode conter strings reservadas do sistema ou prefixos especiais. Para obter detalhes, consulte Limites de parâmetros. |
|
MessageType |
Tipo de mensagem do tópico. |
|
|
Remark |
Descrição do tópico. |
De 1 a 60 caracteres. |
Exemplo:
|
TopicName |
MessageType |
Remark |
|
Topic1 |
TRANSACTION |
Envio de mensagens transacionais. |
|
Topic2 |
NORMAL |
Envio de mensagens normais. |
|
Topic3 |
DELAY |
Envio de mensagens atrasadas. |
Etapas de importação
Faça logon 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 no nome da instância de destino.
No painel de navegação à esquerda, clique em Topics.
No canto superior direito da página Topics, clique em no ícone
.Selecione o arquivo .xlsx e clique em Open.
No painel Import Resources, selecione os tópicos a importar e clique em Confirm and Import na coluna Actions. Para importar vários tópicos simultaneamente, selecione-os e clique em Batch Import.
Quando a coluna Execution Results exibir Imported para cada tópico, clique em OK no canto inferior esquerdo do painel Import Resources.
Os tópicos importados agora aparecem na lista de tópicos da instância de destino.