オンライン DDL ツールの TiDB データ移行サポート
MySQL エコシステムでは、gh-ost や pt-osc などのツールが広く使用されています。 TiDB Data Migration (DM) は、不要な中間データの移行を回避するために、これらのツールのサポートを提供します。
このドキュメントでは、DM における一般的なオンライン DDL ツールのサポート、使用方法、注意事項について紹介します。
オンライン 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"