配置Data Migration Tool

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
配置

创建对象：

有经验的
管理员
开发人员

安装Data Migration Tool后，以下目录包含映射和配置文件：

Magento Open Source：
- <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource：从Magento Open Source1迁移到Magento Open Source2的配置和脚本
Adobe Commerce：
- <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-commerce：从Magento Open Source1迁移到Adobe Commerce 2的配置和脚本
- <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/commerce-to-commerce：从Adobe Commerce 1迁移到Adobe Commerce 2的配置和脚本

配置迁移

有两种方法可配置Data Migration Tool：

在单独的模块中配置Data Migration Tool（推荐）
更改<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/目录中的Data Migration Tool配置。

要使用源代码管理迁移配置并将其用于部署，您必须创建一个单独的模块。
如果您计划仅在本地运行Data Migration Tool，则可以直接编辑<your Magento 2 install dir>/vendor/magento/data-migration-tool/目录中的文件。

在单独的模块中配置迁移

在迁移任何数据之前，必须创建Magento2模块。

创建Magento2模块。

<your Magento 2 install dir>/app/code/Vendor/Migration/composer.json

code language-json

code language-json
`{ "name": "vendor/migration", "description": "Providing config for migration", "config": { "sort-packages": true }, "require": { "magento/framework": "", "magento/data-migration-tool": "" }, "type": "magento2-module", "autoload": { "files": [ "registration.php" ], "psr-4": { "Vendor\\Migration\\": "" } }, "version": "1.0.0" }`

{
    "name": "vendor/migration",
    "description": "Providing config for migration",
    "config": {
        "sort-packages": true
    },
    "require": {
        "magento/framework": "*",
        "magento/data-migration-tool": "*"
    },
    "type": "magento2-module",
    "autoload": {
        "files": [
            "registration.php"
        ],
        "psr-4": {
            "Vendor\\Migration\\": ""
        }
    },
    "version": "1.0.0"
}

<your Magento 2 install dir>/app/code/Vendor/Migration/registration.php

code language-php
`<?php \Magento\Framework\Component\ComponentRegistrar::register( \Magento\Framework\Component\ComponentRegistrar::MODULE, 'Vendor_Migration', __DIR__ );`

<your Magento 2 install dir>/app/code/Vendor/Migration/etc/module.xml

code language-xml

code language-xml
`<?xml version="1.0"?> <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd"> <module name="Vendor_Migration" setup_version="1.0.0"> <sequence> <module name="Magento_DataMigrationTool"/> </sequence> </module> </config>`

<?xml version="1.0"?>

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="Vendor_Migration" setup_version="1.0.0">
        <sequence>
            <module name="Magento_DataMigrationTool"/>
        </sequence>
    </module>
</config>

将config.xml.dist配置文件从Data Migration Tool (<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>)的相应目录复制到<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/config.xml文件中。

例如，如果将Magento 1.9.3.6 Community Edition迁移到Magento 2 Open Source：

code language-bash
`cd <your Magento 2 install dir>`

code language-bash
`cp vendor/magento/data-migration-tool/etc/opensource-to-opensource/1.9.3.6/config.xml.dist app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.3.6/config.xml`

在config.xml文件中，必须设置M1和M2数据库的访问详细信息以及加密密钥。
如果M1存储区有自定义更改，则应将其余配置文件映射到Magento1存储区自定义设置。请参阅使用配置和映射文件。

在`vendor`文件夹中配置迁移

在迁移任何数据之前，必须从提供的示例中创建config.xml配置文件。

要配置Data Migration Tool以进行迁移，请执行以下操作：

以文件系统所有者的身份登录或切换到您的应用程序服务器。

切换到以下目录：

code language-bash
`<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>`

输入以下命令以从提供的示例创建config.xml：

code language-bash
`cp config.xml.dist config.xml`

在文本编辑器中打开config.xml。

config.xml文件至少必须包含对M1和M2数据库的访问详细信息以及加密密钥。

code language-xml
`<source> <database host="127.0.0.1" name="magento1" user="root"/> </source> <destination> <database host="127.0.0.1" name="magento2" user="root"/> </destination> <options> <crypt_key /> </options>`

<crypt_key>标记必须包含一个值。您可以在<key>标记中找到它，该标记位于Magento1实例上的app/etc/local.xml文件中。

可选参数：

数据库用户密码： password=<password>
数据库自定义端口： port=<port>
表前缀： <source_prefix>，<dest_prefix>

例如，如果数据库所有者的用户名是root，密码为pass，而您在Magento1数据库中使用前缀magento1，请在config.xml中使用以下内容：

code language-xml

code language-xml
`<source> <database host="127.0.0.1" name="magento1" user="root" password="pass"/> </source> <destination> <database host="127.0.0.1" name="magento2" user="root" password="pass"/> </destination> <options> <source_prefix>magento1</source_prefix> <crypt_key>f3e25abe619dae2387df9fs594f01985</crypt_key> </options>`

<source>
   <database host="127.0.0.1" name="magento1" user="root" password="pass"/>
</source>
<destination>
   <database host="127.0.0.1" name="magento2" user="root" password="pass"/>
</destination>
<options>
   <source_prefix>magento1</source_prefix>
   <crypt_key>f3e25abe619dae2387df9fs594f01985</crypt_key>
</options>

完成后，将更改保存到config.xml并退出文本编辑器。

使用TLS协议连接

您还可以使用TLS协议（即使用公共/专用加密密钥）连接到数据库。将以下可选属性添加到database元素：

ssl_ca
ssl_cert
ssl_key

例如：

<source>
    <database host="localhost" name="magento1" user="root" ssl_ca="/path/to/file" ssl_cert="/path/to/file" ssl_key="/path/to/file"/>
</source>
<destination>
    <database host="localhost" name="magento2" user="root" ssl_ca="/path/to/file" ssl_cert="/path/to/file" ssl_key="/path/to/file"/>
</destination>

使用配置和映射文件

Data Migration Tool使用 映射文件 来允许您在Magento1和Magento2数据库之间执行自定义数据库映射，包括：

更改表名
更改字段名称
忽略表或字段
将字段的传输数据调整为Magento2格式

受支持Magento版本的映射文件位于<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc的子目录中

要使用映射文件，请执行以下操作：

将它们从<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>/复制到<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/并删除.dist扩展。
更新config.xml的<options>节点中新复制文件的路径。更新的路径应为以下路径之一：
1. 绝对文件路径，如/var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
2. magento/data-migration-tool模块相对文件路径： etc/opensource-to-opensource/1.9.4.1/map.xml
3. 根目录相对文件路径Magento： app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml

<Magento 2 dir>/vendor/magento/data-migration-tool/etc和<Magento 2 dir>/vendor/magento/data-migration-tool/etc/<ce version>目录包含以下配置文件：

即使您大部分时间都在使用map.xml.dist文件，下表仍讨论了每个映射和其他文件。

映射文件名

描述

class-map.xml.dist

Magento1和Magento2之间类映射的字典

config.xml.dist

指定Magento1和Magento2数据库配置、步骤配置以及映射到文件的链接的主配置文件

仅限Adobe Commerce。customer-attr-document-groups.xml.dist

自定义客户属性步骤中使用的表的列表。

仅限Adobe Commerce。customer-attr-map.xml.dist

在自定义客户属性步骤中使用的映射文件。

deltalog.xml.dist

包含数据库例程设置所需的表列表。

eav-attribute-groups.xml.dist

包含在Eav步骤中使用的属性列表。

eav-document-groups.xml.dist

包含在Eav步骤中使用的表的列表。

log-document-groups.xml.dist

包含日志步骤中使用的表的列表。

map-eav.xml.dist

EAV步骤中使用的映射文件。

map-log.xml.dist

日志映射文件。

仅限Adobe Commerce。map-sales.xml.dist

SalesOrder Step中使用的映射文件。

map.xml.dist

映射步骤所需的映射文件。

settings.xml.dist

正在设置迁移配置文件，该文件指定迁移core_config_data表所需的规则。

customer-attribute-groups.xml.dist

包含客户属性步骤中使用的属性列表。

customer-document-groups.xml.dist

包含客户属性步骤中使用的表的列表。

map-customer.xml.dist

映射在客户属性步骤中使用的文件。

order-grids-document-groups.xml.dist

包含在OrderGrids步骤中使用的表的列表。

map-document-groups.xml.dist

定义在数据插入时出现重复时更新哪些字段

map-stores.xml.dist

在存储步骤中使用的映射文件。

map-tier-price.xml.dist

在层价格步骤中使用的映射文件。

仅限Adobe Commerce。visual_merchandiser_map.xml.dist

VisualMerchandiser步骤中使用的映射文件。

仅限Adobe Commerce。visual_merchandiser_attribute_groups.xml.dist

包含在VisualMerchandiser步骤中使用的属性列表。

仅限Adobe Commerce。visual_merchandiser_document_groups.xml.dist

包含在VisualMerchandiser步骤中使用的表的列表。

有关详细信息，请参阅Data Migration Tool 技术规范。

recommendation-more-help

c2d96e17-5179-455c-ad3a-e1697bb4e8c3