オンライン 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 以降のバージョンでは、 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"