Ao migrar de uma instância do ApsaraMQ for RocketMQ para outra ou manter configurações idênticas entre os ambientes de desenvolvimento, teste e produção, recriar tópicos manualmente é uma tarefa tediosa e propensa a erros. O recurso de exportação e importação de dados de tópicos permite exportar metadados de tópicos de uma instância de source como um arquivo .xlsx e importá-los para 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, como nomes, tipos de mensagem e descrições. A exportação e a importação não afetam nem migram as mensagens armazenadas nos tópicos. O recurso oferece suporte à exportação e à importação entre versões diferentes. Por exemplo, você pode exportar dados de uma instância 4.x e importá-los para uma instância 5.x.
Casos de uso
Migração de instância: exporte dados de tópicos de uma instância do ApsaraMQ for RocketMQ 4.x e importe-os para uma instância 5.x. Isso recria todos os tópicos automaticamente na nova instância.
Clonagem de ambiente: defina os tópicos uma única vez e, em seguida, exporte-os 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 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 de source.
No painel de navegação à esquerda, clique em Topics.
No canto superior direito da página Topics, clique em ícone
.
O sistema salva os dados do tópico em um arquivo .xlsx na sua máquina local.
Importar dados de tópicos
Importe o arquivo .xlsx exportado diretamente ou atualize-o com base nos requisitos do seu negócio antes de importá-lo.
Requisitos de formato de arquivo
O arquivo .xlsx deve conter as seguintes colunas:
|
Parâmetro |
Descrição |
Valores válidos |
|
TopicName |
O 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 mais detalhes, consulte Limits on parameters. |
|
MessageType |
O tipo de mensagem do tópico. |
|
|
Remark |
Uma 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 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 de destino.
No painel de navegação à esquerda, clique em Topics.
No canto superior direito da página Topics, clique em ícone
.Selecione o arquivo .xlsx e clique em Open.
No painel Import Resources, selecione os tópicos que deseja importar 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.
Quando 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.