Data Migration Tool の設定
Data Migration Tool をインストールすると、次のディレクトリにマッピングおよび設定ファイルが格納されます。
-
Magento Open Source:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource
:Magento Open Source 1 からMagento Open Source 2 への移行用の設定およびスクリプト
-
Adobe Commerce:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-commerce
:Magento Open Source 1 から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 を設定する方法は 2 つあります。
- 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/
ディレクトリ内のファイルを直接編集できます。
別のモジュールでの移行の設定
データをマイグレーションする前に、Magento 2 モジュールを作成する必要があります。
-
Magento 2 モジュールを作成します。
<your Magento 2 install dir>/app/code/Vendor/Migration/composer.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" }
<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 <?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>
-
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
ファイルにconfig.xml.dist
設定ファイルをコピーします。例えば、
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 ストアにカスタムの変更がある場合は、残りの設定ファイルをMagento 1 ストアのカスタマイズにマッピングする必要があります。 設定およびマッピングファイルの操作を参照してください。
フォルダーでの移行 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>
タグ内で検索できます。このタグは、Magento 1 インスタンスのapp/etc/local.xml ファイルにあります。オプションのパラメーター:
- データベース ユーザーのパスワード:
password=<password>
- データベースのカスタム ポート:
port=<port>
- テーブルのプレフィックス:
<source_prefix>
、<dest_prefix>
root
たとえば、データベース所有者のユーザー名が passwordpass
で、Magento 1 データベースでプレフィックスmagento1
を使用する場合は、config.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>
- データベース ユーザーのパスワード:
終了したら、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 のデータベース間で次のようなカスタム・データベース・マッピングを実行できます。
-
テーブル名の変更
-
フィールド名の変更
-
テーブルまたはフィールドの無視
-
フィールドのデータをMagento 2 形式に変換する
サポートされている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>
ノードにある新しくコピーしたファイルへのパスを更新します。 更新されるパスは次のいずれかである必要があります。- 絶対ファイルパス(例:
/var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
) - magento/data-migration-tool モジュールの相対ファイル パス:
etc/opensource-to-opensource/1.9.4.1/map.xml
- 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
config.xml.dist
customer-attr-document-groups.xml.dist
customer-attr-map.xml.dist
deltalog.xml.dist
eav-attribute-groups.xml.dist
eav-document-groups.xml.dist
log-document-groups.xml.dist
map-eav.xml.dist
map-log.xml.dist
map-sales.xml.dist
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
map-document-groups.xml.dist
map-stores.xml.dist
map-tier-price.xml.dist
visual_merchandiser_map.xml.dist
visual_merchandiser_attribute_groups.xml.dist
visual_merchandiser_document_groups.xml.dist
詳細については、「技術仕様 Data Migration Tool を参照てください。