DocumentazioneCommerceAdobe Commerce as a Cloud Service

[Solo SaaS]{class="badge positive" title="Applicabile solo ai progetti Adobe Commerce as a Cloud Service e Adobe Commerce Optimizer (infrastruttura SaaS gestita da Adobe)."}

Strumento di migrazione dati in blocco

Last update: Wed Aug 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

Lo strumento di migrazione di massa dei dati segue un’architettura distribuita che consente una migrazione sicura ed efficiente dei dati dagli ambienti PaaS agli ambienti SaaS. Questo strumento è progettato per consentire ai responsabili dell'implementazione della soluzione di migrare i dati da un'istanza esistente di Adobe Commerce on Cloud (PaaS) a Adobe Commerce as a Cloud Service (SaaS). Per ulteriori informazioni sul processo di migrazione, vedere Panoramica sulla migrazione.

NOTE
Lo strumento di migrazione dei dati in blocco supporta solo la migrazione dei dati di e-commerce di prime parti. La migrazione dei dati personalizzati non è attualmente supportata.

L’immagine seguente descrive l’architettura e i componenti chiave per l’utilizzo dello strumento Bulk Data Migration.

Architettura dello strumento di migrazione dati in blocco

Flusso di lavoro di migrazione

Il flusso di lavoro di migrazione dei dati in blocco è costituito dai seguenti passaggi:

  1. Imposta un nuovo ambiente per la migrazione.
  2. Copia i dati dal vecchio sistema.
  3. Sposta i dati nel nuovo sistema.
  4. Rendi il catalogo dei prodotti disponibile nel nuovo sistema.
  5. Verifica che i dati siano stati migrati correttamente.

Le sezioni seguenti descrivono in dettaglio questi passaggi.

Accedere allo strumento di migrazione dei dati in blocco

Lo strumento di migrazione dei dati in blocco è disponibile come segue:

  • T4 2025 - Per accedere allo strumento di migrazione dati in blocco, invia un ticket di supporto.
  • T4 2025 - Lo strumento di migrazione dati in blocco sarà disponibile al pubblico e sarà accessibile da questa pagina.

Creare un ambiente di destinazione

Il Solution Implementer (SI) crea un ambiente di destinazione per la migrazione. Questo ambiente viene utilizzato per archiviare i dati migrati dall’istanza di origine.

Innanzitutto, crea una nuova istanza Adobe Commerce as a Cloud Service (SaaS).

Configura strumento di estrazione

Lo strumento di estrazione viene utilizzato per estrarre i dati dall’istanza di origine.

  1. Scarica lo strumento di estrazione dal collegamento fornito da Adobe.

  2. Imposta le seguenti variabili di ambiente nello strumento di estrazione:

    • Dettagli di connessione al database MySQL esistente

    • ID tenant di destinazione per l'istanza Adobe Commerce as a Cloud Service

    • Le tue credenziali IMS, tra cui:

      • ID client
      • Segreto client
      • Ambiti IMS
      • URL IMS: l’URL di base. Ad esempio, https://ims-na1.adobelogin.com/.
      • ID organizzazione IMS

    Per ambiti IMS e altri valori, seleziona il tipo OAuth nella sezione Credenziali all'interno del progetto in Adobe Developer Console. Ulteriori informazioni sono fornite nel file .example.env incluso con lo strumento di estrazione.

Estrai dati

Prima di eseguire lo strumento di estrazione, l’implementatore della soluzione deve stabilire un tunnel SSH per il database PaaS utilizzando:

magento-cloud tunnel:open

Quindi esegui lo strumento di estrazione, che:

  1. Connettiti al database PaaS, analizzane lo schema e confrontalo con i dettagli dello schema del tenant SaaS.
  2. Genera un piano di estrazione e trasformazione basato sugli elementi dello schema comuni tra PaaS e SaaS.
  3. Estrai i dati utilizzando Catalog Data Management Service (CDMS).

Carica dati

Esegui lo strumento di caricamento dati fornito da Adobe. Questo strumento:

  1. Connettersi al database tenant SaaS utilizzando un account di migrazione.
  2. Genera un piano di caricamento.
  3. Esegui il piano, spostando i dati nel database del tenant SaaS in batch.
  4. Elabora i file multimediali del catalogo e trasferiscili nell'ambiente di destinazione.
  5. Svuota la cache Redis SaaS e invalida gli indici di database per il tenant.

Dopo il caricamento dei dati, i dati del catalogo passano automaticamente dal database tenant SaaS a Catalog Service.

Catalog Service condivide questi dati con Live Search e Product Recommendations. Non è richiesto alcun intervento manuale per questo processo. I dati saranno disponibili in tutti i servizi al termine dell’acquisizione.

Verifica dell’integrità dei dati

Dopo la migrazione, CDMS esegue i seguenti controlli automatici di integrità dei dati per garantire l’accuratezza e la completezza dei dati migrati:

Verifica basata su API

Durante la verifica, CDMS confronta le risposte REST e API di GraphQL da query eseguite in precedenza con i record corrispondenti dell’istanza di destinazione. Eventuali discrepanze sono visibili nello stato di migrazione.

Verifica a livello di database

Durante la verifica, CDMS conta il numero di record estratti e confronta tale numero con la quantità di record caricati.

Verifica su richiesta (facoltativa)

È inoltre possibile attivare manualmente la verifica completa di tutti i record di sistema:

NOTE
Questo processo richiede molte risorse e deve essere utilizzato solo in ambienti sandbox.

La verifica completa comprende:

  • Verifica completa basata su API utilizzando tutte le risposte API REST e GraphQL pre-estratte
  • Rapporto dettagliato di eventuali incongruenze riscontrate
recommendation-more-help
8562d99f-dbeb-485e-bae7-5e82fa87f463