オンライン DDL ツールの TiDB データ移行サポート
MySQL エコシステムでは、gh-ost や pt-osc などのツールが広く使用されています。TiDB データ移行 (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: trueはonline-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"