Todos os produtos
Search

Este produto

    ApsaraMQ for RocketMQ:Exportar e importar dados de grupos

    Central de documentação

    ApsaraMQ for RocketMQ:Exportar e importar dados de grupos

    Última atualização: Jun 27, 2026

    Ao migrar para uma nova instância do ApsaraMQ for RocketMQ ou replicar configurações entre ambientes, recriar grupos de consumidores manualmente é um processo demorado e sujeito a 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 os grupos com a mesma configuração básica.

    Casos de uso

    Cenário

    Descrição

    Migração de instância

    Exporte os dados de grupos da instância atual e importe-os em uma instância recém-adquirida. Os grupos são recriados automaticamente com a mesma configuração básica.

    Clonagem de ambiente

    Replique a mesma configuração de grupos nas instâncias de desenvolvimento, teste e produção sem precisar recriar cada grupo manualmente.

    O que é exportado

    A exportação inclui apenas metadados dos grupos:

    • IDs de grupo

    • Políticas de consumo

    • Descrições dos grupos

    Importante

    Assinaturas e dados de mensagens não são exportados nem migrados. Apenas a configuração básica do grupo é transferida entre instâncias.

    Compatibilidade entre versões

    As instâncias do ApsaraMQ for RocketMQ 4.x e 5.x utilizam esquemas de metadados de grupos diferentes. Consulte as regras de compatibilidade antes de iniciar:

    Direção

    Suportado

    Observações

    5.x para 4.x

    Sim

    Importe diretamente. Apenas os campos suportados pela versão 4.x entram em vigor. Consulte a Etapa 5 do procedimento de importação para obter detalhes.

    4.x para 5.x

    Requer edição

    Modifique o arquivo exportado antes de importar. Consulte a Etapa 5 do procedimento de importação da versão 5.x para verificar as alterações necessárias nos parâmetros.

    Exportar dados de grupos

    Pré-requisitos

    Antes de começar, verifique se você possui:

    • Uma instância do ApsaraMQ for RocketMQ com grupos de consumidores existentes

    • Permissões para acessar o console do ApsaraMQ for RocketMQ

    Procedimento

    1. Faça login no console do ApsaraMQ for RocketMQ. No painel de navegação à esquerda, clique em Instances.

    2. Na barra de navegação superior, selecione uma região, como China (Hangzhou). Na página Instances, clique em o nome da instância que deseja gerenciar.

    3. No painel de navegação à esquerda, clique em Groups.

    4. No canto superior direito da página Groups, clique em o ícone 导出.

    Os dados dos grupos são salvos como um arquivo .xlsx na sua máquina local.

    Importar dados de grupos

    É possível importar o arquivo exportado diretamente ou editá-lo previamente para atender aos seus requisitos.

    Pré-requisitos

    Antes de começar, verifique se você possui:

    • Um arquivo .xlsx com dados de grupos (exportado de outra instância ou criado manualmente)

    • Uma instância de destino do ApsaraMQ for RocketMQ

    • Permissões para acessar o console do ApsaraMQ for RocketMQ

    Procedimento

    1. Faça login no console do ApsaraMQ for RocketMQ. No painel de navegação à esquerda, clique em Instances.

    2. Na barra de navegação superior, selecione uma região, como China (Hangzhou). Na página Instances, clique em o nome da instância de destino.

    3. No painel de navegação à esquerda, clique em Groups.

    4. No canto superior direito da página Groups, clique em o ícone 导入.

    5. Selecione o arquivo de dados de grupos na sua máquina local e clique em Open. O arquivo deve seguir os requisitos de parâmetros listados abaixo.

      Parâmetro

      Descrição

      Requisitos

      ConsumerGroupId

      O ID do grupo.

      Letras, dígitos, sublinhados (_) e hifens (-). Prefixo recomendado: GID_ ou GID-. Comprimento: 2 a 64 caracteres.

      ConsumerGroupType

      O protocolo utilizado pelo grupo. Crie grupos separados para clientes HTTP e TCP.

      TCP ou HTTP

      Remark

      Uma breve descrição do grupo.

      1 a 60 caracteres.

      Exemplo de conteúdo do arquivo

      ConsumerGroupId

      ConsumerGroupType

      Remark

      GID_test1

      HTTP

      Utilizado para clientes HTTP.

      GID_test2

      TCP

      Utilizado para clientes TCP.

    6. 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.

    7. Verifique se a coluna Execution Results exibe Imported para cada grupo.

    8. No canto inferior esquerdo do painel Import Resources, clique em OK para concluir.

    Os grupos importados agora aparecem na lista de grupos da instância de destino.

    Veja também