Ao migrar de uma instância do ApsaraMQ for RocketMQ para outra ou ao manter configurações idênticas de tópicos nos ambientes de desenvolvimento, teste e produção, a recriação manual é trabalhosa 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 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, você pode 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 e importe-os entre as 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 no nome da instância source.
No painel de navegação à esquerda, clique em Topics.
No canto superior direito da página Topics, clique 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 mais detalhes, consulte Limits on parameters. |
|
MessageType |
Tipo de mensagem do tópico. |
|
|
Remark |
Descrição do tópico. |
De 1 a 60 caracteres. |
Exemplo:
|
TopicName |
MessageType |
Remark |
|
Topic1 |
TRANSACTION |
Usado para enviar mensagens transacionais. |
|
Topic2 |
NORMAL |
Usado para enviar mensagens normais. |
|
Topic3 |
DELAY |
Usado para enviar 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 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 no ícone
.Selecione o arquivo .xlsx e clique em Open.
No painel Import Resources, selecione os tópicos a serem importados e clique em Confirm and Import na coluna Actions. Para importar vários tópicos de uma vez, selecione-os e clique em Batch Import.
Depois que a coluna Execution Results exibir Imported para cada tópico, clique em Complete no canto inferior esquerdo do painel Import Resources.
Os tópicos importados agora aparecem na lista de tópicos da instância de destino.