ドキュメントCommerceツール

Data Migration Toolをアップグレード

最終更新日： 2026年5月4日

作成対象：

  • Experienced
  • Admin
  • Developer

現在のMagento 2 インストールとData Migration Toolのバージョンが正確に一致することを確認するには、ツールをアップグレードする必要がある場合があります。

前提条件

Data Migration Toolをアップグレードする前に、次の操作を行う必要があります。

  • Magento ソフトウェアをアップグレードして最新バージョンを入手する

  • vendor/magento/data-migration-tool ディレクトリのバックアップ

  • Data Migration Tool バージョンがMagento アプリケーションのバージョンと一致していることを確認してください

Magento ソフトウェアのアップグレード

まだアップグレードしていない場合は、Magento ソフトウェアをアップグレードしてください。

vendor/magento/data-migration-tool ディレクトリのバックアップ

Data Migration Toolをアップグレードする前に、少なくともvendor/magento/data-migration-tool ディレクトリをバックアップしてください。 アップグレード中に、更新されたコードで削除および置き換えられる可能性があります。

次のコマンドを使用して、Magento コードベースとデータベース全体をバックアップすることもできます。

php <magento_root>/bin/magento setup:backup --code --db
WARNING
vendor/magento/data-migration-tool ディレクトリにカスタムコードが含まれています。 バックアップに失敗すると、アップグレード中にカスタマイズが失われる可能性があります。

バージョンが一致することを確認します

Data Migration ToolとMagento ソフトウェアのバージョンは正確に一致する必要があります。 例えば、Magento 2.1.2では、Data Migration Toolのバージョン 2.1.2が必要です。

Install Data Migration Tool トピックを参照して、以下の方法を確認してください。

  • Magento 2のバージョンを確認してください

  • FindがリリースしたData Migration Toolのバージョン

  • Data Migration Tool バージョンを​ チェック ​

Data Migration Toolをアップグレード

  1. アプリケーションサーバーに​ ファイルシステム所有者としてログインするか、切り替えます。

  2. アプリケーションのルートディレクトリに移動します。

  3. 次のコマンドを入力します。

    code language-shell 
    composer require magento/data-migration-tool:<version>

    ここで、<version>はMagento 2 コードベースのバージョンと一致する必要があります。

    例えば、バージョン 2.1.2の場合、次のように入力します。

    code language-shell 
    composer require magento/data-migration-tool:2.1.2

  4. コマンドが完了するまでお待ちください。

recommendation-more-help
commerce-operations-help-tools