How migration works
This document uses the following terminology to discuss the Data Migration Tool:
Step: A unique migration task that must be executed in a prescribed order
Map: A set of rules that describe connections between Magento 1.x and Magento 2.x data structures
Mode: Represented by a separate Data Migration Tool command, defines the basic mode of operation as:
Settings: Migrates the system configuration and website-related settings
Data: Migrates database assets in bulk
Delta: Migrates incremental changes (for example, orders and inventory)
Migration modes (phases)
This guide provides information about migration using the Data Migration Tool that can transfer and adapt data from Magento 1 to Magento 2 stores. The migration in overall is split into three phases (or “modes”):
Delta (changes since the last run)
Each mode is divided into steps, each of which is responsible for transferring particular data (for example, URL rewrite step, EAV step, settings step, and so on). At the begin of a run, a step checks the table structures of Magento 1 and Magento 2 for consistency. Then the actual data is transferred to Magento 2. In the end, this data is verified.
This section previews your migration experience by providing a high-level overview of the Data Migration Tool.
The data migration tool recognizes the differences in database structure between Magento 1.x versions. Most of these database structural differences are declared in map files. Each step in the process uses map files to transform data for use in your Magento 2 store.
For example, when you transform data from a Magento Open Source 22.214.171.124 database to Magento Open Source 2.x.x, the map file accounts for the fact that a table was renamed and renames it accordingly in the destination database. If there are no differences in data structure or data format, the Data Migration Tool transfers it as-is to the Magento 2 database, including data from tables created by extensions.
When differences are not declared in map files, then the Data Migration Tool displays an error and does not start.
Mapping files are discussed in more detail in Data Migration Tool Technical Specification.
Migration flow diagram