オンライン DDL ツールの TiDB データ移行サポート
MySQL エコシステムでは、gh-ost や pt-osc などのツールが広く使用されています。 TiDB データ移行 (DM) は、不要な中間データの移行を避けるために、これらのツールをサポートします。
このドキュメントでは、一般的なオンライン DDL ツールのサポート、使用方法、および DM での注意事項について紹介します。
オンライン DDL ツールの DM の動作原理と実装方法については、 オンライン ddlを参照してください。
制限
- DM は gh-ost と pt-osc のみをサポートします。
online-ddlが有効な場合、増分レプリケーションに対応するチェックポイントは、オンライン DDL 実行のプロセスにあってはなりません。たとえば、アップストリームのオンライン DDL 操作がbinlogのposition-Aで開始し、position-Bで終了する場合、増分レプリケーションの開始点はposition-Aより前またはposition-Bより後である必要があります。そうしないと、エラーが発生します。詳細はFAQを参照してください。
パラメータの構成
- v2.0.5 and later
- earlier than v2.0.5
v2.0.5 以降のバージョンでは、 task構成ファイルのonline-ddl構成アイテムを使用する必要があります。
- 上流の MySQL/MariaDB が (同時に) gh-ost または pt-osc ツールを使用する場合は、タスク構成ファイルで
online-ddlからtrueを設定します。
online-ddl: true
ノート：
v2.0.5 以降、
online-ddl-scheme廃止されたため、online-ddl-schemeの代わりにonline-ddl使用する必要があります。つまり、設定online-ddl: trueonline-ddl-schemeを上書きし、設定online-ddl-scheme: "pt"またはonline-ddl-scheme: "gh-ost"はonline-ddl: trueに変換されます。
v2.0.5 より前 (v2.0.5 を除く) では、 task構成ファイルのonline-ddl-scheme構成アイテムを使用する必要があります。
- アップストリームの MySQL/MariaDB が gh-ost ツールを使用している場合は、タスク構成ファイルで設定します。
online-ddl-scheme: "gh-ost"
- アップストリームの MySQL/MariaDB が pt ツールを使用している場合は、タスク構成ファイルで設定します。
online-ddl-scheme: "pt"