[Somente SaaS]{class="badge positive" title="Aplicável somente a projetos do Adobe Commerce as a Cloud Service e do Adobe Commerce Optimizer (infraestrutura SaaS gerenciada pela Adobe)."}

Ferramenta de migração de dados em massa

A ferramenta de migração de dados em massa segue uma arquitetura distribuída que permite a migração de dados segura e eficiente de PaaS para ambientes SaaS. Esta ferramenta ajuda os implementadores da solução a migrar dados de uma instância existente do Adobe Commerce na nuvem (PaaS) para Adobe Commerce as a Cloud Service (SaaS). Para obter mais informações sobre o processo de migração, consulte a Visão geral da migração.

NOTE
A ferramenta de migração de dados em massa é compatível com a migração somente de dados principais de comércio primários. No momento, não há suporte para a migração de dados personalizada.

A imagem a seguir detalha a arquitetura e os principais componentes para usar a ferramenta Migração de dados em massa.

Diagrama da arquitetura da Ferramenta de Migração de Dados em Massa mostrando o fluxo de dados PaaS para SaaS {modal="regular"}

Fluxo de trabalho de migração

O fluxo de trabalho de migração de dados em massa consiste nas seguintes etapas:

  1. Configure um novo ambiente para sua migração.
  2. Copie os dados do sistema antigo.
  3. Mova seus dados para o novo sistema.
  4. Disponibilize seu catálogo de produtos no novo sistema.
  5. Confirme se os dados foram migrados corretamente.

As seções a seguir descrevem essas etapas em detalhes.

Acessar a ferramenta de migração de dados em massa

A disponibilidade da ferramenta de migração de dados em massa é a seguinte:

  • T4 2025 (ainda não disponível) - Após a versão inicial da ferramenta de migração de dados em massa, você poderá acessá-la enviando um tíquete de suporte.
  • T4 2025 (ainda não disponível) - Após o lançamento público da ferramenta de migração de dados em massa, ela estará acessível nesta página.

Criar ambiente de destino

O implementador de soluções (SI) cria um ambiente de destino para a migração. Esse ambiente armazena os dados migrados da instância de origem.

Primeiro, crie uma nova instância Adobe Commerce as a Cloud Service (SaaS).

Configurar ferramenta de extração

Use a ferramenta de extração para extrair dados da instância de origem.

  1. Baixe a ferramenta de extração no link fornecido pelo Adobe.

  2. Defina as seguintes variáveis de ambiente na ferramenta de extração:

    • Detalhes da conexão com o banco de dados MySQL existente

    • A ID do locatário de destino para sua instância Adobe Commerce as a Cloud Service

    • Suas credenciais IMS, incluindo:

      • ID do cliente
      • Client secret
      • Escopos IMS
      • URL IMS - O URL de base. Por exemplo, https://ims-na1.adobelogin.com/.
      • IMS organization ID

    Para escopos IMS e outros valores, selecione seu tipo OAuth na seção Credenciais dentro do projeto na Adobe Developer Console. Mais informações são fornecidas no arquivo .example.env incluído com a ferramenta de extração.

Extrair dados

Antes de executar a ferramenta de extração, o implementador da solução deve estabelecer um túnel SSH para o banco de dados PaaS usando:

magento-cloud tunnel:open

Em seguida, execute a ferramenta de extração, que:

  1. Conecte-se ao banco de dados PaaS, analise seu esquema e compare-o com os detalhes do esquema do locatário SaaS.
  2. Gerar um plano de extração e transformação com base nos elementos de esquema comuns entre PaaS e SaaS.
  3. Extraia os dados usando o Serviço de gerenciamento de dados de catálogo (CDMS).

Carregar dados

Execute a ferramenta carregar dados fornecida pelo Adobe. Essa ferramenta irá:

  1. Conecte-se ao banco de dados de locatários SaaS usando uma conta de migração.
  2. Gerar um plano de carregamento.
  3. Execute o plano, movendo dados para o banco de dados de locatários SaaS em lotes.
  4. Processe a mídia do catálogo e transfira-a para o ambiente de destino.
  5. Limpe o cache SaaS Redis e invalide os índices do banco de dados do locatário.

Depois que os dados são carregados, os dados do catálogo fluem automaticamente do banco de dados do locatário SaaS para o Serviço de catálogo.

O Serviço de catálogo compartilha esses dados com o Live Search e as Recomendações de produto. Nenhuma intervenção manual é necessária para esse processo. Os dados são disponibilizados em todos os serviços após a conclusão da assimilação.

Verificação da integridade dos dados

Após a migração, o CDMS executa as seguintes verificações automáticas de integridade de dados para garantir a precisão e a integridade dos dados migrados:

Verificação baseada em API

Durante a verificação, o CDMS compara as respostas da API REST e GraphQL de consultas executadas anteriormente com os registros correspondentes da instância de destino. Todas as discrepâncias são visíveis no status da migração.

Verificação no nível do banco de dados

Durante a verificação, o CDMS conta o número de registros extraídos e compara esse número à quantidade de registros carregados.

Verificação sob demanda (opcional)

Você também pode acionar manualmente a verificação abrangente de todos os registros do sistema:

NOTE
Esse processo consome muitos recursos e só deve ser usado em ambientes de sandbox.

A verificação completa inclui:

  • Verificação completa baseada em API usando todas as respostas pré-extraídas da REST e da API do GraphQL
  • Relatório detalhado de todas as inconsistências encontradas
recommendation-more-help
0519caf3-99f4-44ba-8e03-411a5b7764c8