重要

古いバージョンの TiDB データベース (TiDB {{ curdocVersion }}) のドキュメントを表示しています。

TiDBデータベースの最新の安定バージョンを使用することをお勧めします。
重要
このページは英語版のページを機械翻訳しています。原文はこちらからご覧ください。

オプティミスティックモードでシャードテーブルからデータをマージおよび移行する

このドキュメントでは、オプティミスティックモードのデータ移行(DM)によって提供されるシャーディングサポート機能を紹介します。この機能を使用すると、アップストリームのMySQLまたはMariaDBインスタンスにある同じまたは異なるテーブルスキーマを持つテーブルのデータを、ダウンストリームのTiDBにある1つの同じテーブルにマージして移行できます。

ノート:

オプティミスティックモードとその制限について詳しく理解していない場合は、このモードを使用することはお勧めしません。そうしないと、移行の中断やデータの不整合が発生する可能性があります。

バックグラウンド

DMは、シャーディングDDLと呼ばれるシャーディングテーブルでのオンラインでのDDLステートメントの実行をサポートし、デフォルトで「ペシミスティックモード」を使用します。このモードでは、アップストリームのシャードテーブルでDDLステートメントが実行されると、他のすべてのシャードテーブルで同じDDLステートメントが実行されるまで、このテーブルのデータ移行が一時停止されます。その時までに、このDDLステートメントがダウンストリームで実行され、データ移行が再開されます。

ペシミスティックモードは、ダウンストリームに移行されたデータが常に正しいことを保証しますが、データ移行を一時停止します。これは、アップストリームでA/Bを変更するのに適していません。場合によっては、ユーザーは単一のシャードテーブルでDDLステートメントを実行するのに長い時間を費やし、検証期間の後にのみ他のシャードテーブルのスキーマを変更することがあります。ペシミスティックモードでは、これらのDDLステートメントはデータ移行をブロックし、多くのbinlogイベントを積み上げます。

したがって、「楽観的なモード」が必要です。このモードでは、シャードテーブルで実行されたDDLステートメントは、他のシャードテーブルと互換性のあるステートメントに自動的に変換され、すぐにダウンストリームに移行されます。このように、DDLステートメントはシャードテーブルによるDML移行の実行をブロックしません。

楽観的なモードのConfiguration / コンフィグレーション

オプティミスティックモードを使用するには、タスク構成ファイルのshard-mode項目をoptimisticとして指定します。詳細なサンプル構成ファイルについては、 DM高度なタスクConfiguration / コンフィグレーションファイルを参照してください。

制限

楽観的なモードを使用するには、いくつかのリスクが伴います。使用するときは、次のルールに従ってください。

  • DDLステートメントのバッチを実行する前後に、すべてのシャードテーブルのスキーマが互いに整合していることを確認してください。

  • A / Bテストを実行する場合は、1つのシャードテーブルでのみテストを実行してください。

  • A / Bテストが終了したら、最も直接的なDDLステートメントのみを最終スキーマに移行します。テストのすべての正しいステップまたは間違ったステップを再実行しないでください。

    たとえば、シャードテーブルでADD COLUMN A INT; DROP COLUMN A; ADD COLUMN A FLOAT;を実行した場合、他のシャードテーブルでADD COLUMN A FLOATを実行するだけで済みます。 3つのDDLステートメントすべてを再度実行する必要はありません。

  • DDLステートメントを実行するときは、DM移行のステータスを確認してください。エラーが報告された場合、このDDLステートメントのバッチがデータの不整合を引き起こすかどうかを判断する必要があります。

現在、次のステートメントはオプティミスティックモードではサポートされていません。

  • ALTER TABLE table_name ADD COLUMN column_name datatype NOT NULL (デフォルト値なしでNOT NULL列を追加します)。
  • ALTER TABLE table_name ADD COLUMN column_name datetime DEFAULT NOW() (値が変化する列を追加するため)。
  • ALTER TABLE table_name ADD COLUMN col1 INT, DROP COLUMN col2 (1つのDDLステートメントにADD COLUMNDROP COLUMNの両方が含まれます)。
  • ALTER TABLE table_name RENAME COLUMN column_1 TO column_2; (列の名前を変更します)。
  • ALTER TABLE table_name RENAME INDEX index_1 TO index_2; (インデックスの名前を変更します)。

さらに、次の制限が楽観的モードと悲観的モードの両方に適用されます。

  • インクリメンタルレプリケーションタスクでは、タスクの開始時のbinlog位置に対応する各シャーディングテーブルのスキーマが互いに整合していることを確認してください。
  • シャーディンググループに追加された新しいテーブルには、他のメンバーのテーブルスキーマと一貫性のあるテーブルスキーマが必要です。 DDLステートメントのバッチが実行されている場合、 CREATE/RENAME TABLEステートメントは禁止されています。
  • DROP TABLEまたはDROP DATABASEはサポートされていません。
  • TRUNCATE TABLEはサポートされていません。
  • 各DDLステートメントには、1つのテーブルのみに対する操作が含まれている必要があります。
  • TiDBでサポートされていないDDLステートメントは、DMでもサポートされていません。
  • 新しく追加された列のデフォルトrand()には、 current_timestampを含めることはできませuuid() 。そうしないと、アップストリームとダウンストリームの間でデータの不整合が発生する可能性があります。

リスク

移行タスクにオプティミスティックモードを使用すると、DDLステートメントはすぐにダウンストリームに移行されます。このモードを誤用すると、アップストリームとダウンストリームの間でデータの不整合が発生する可能性があります。

データの不整合を引き起こす操作

  • 各シャーディングテーブルのスキーマは互いに互換性がありません。例えば:

    • 同じ名前の2つの列がそれぞれ2つのシャードテーブルに追加されますが、列のタイプは異なります。
    • 同じ名前の2つの列がそれぞれ2つのシャードテーブルに追加されますが、列のデフォルト値は異なります。
    • 同じ名前の2つの生成された列は、それぞれ2つのシャードテーブルに追加されますが、列は異なる式を使用して生成されます。
    • 同じ名前の2つのインデックスが2つのシャードテーブルにそれぞれ追加されますが、キーは異なります。
    • 同じ名前の他の異なるテーブルスキーマ。
  • シャーディングされたテーブルのデータを破損する可能性のあるDDLステートメントを実行してから、ロールバックを試みてください。

    たとえば、列Xを削除してから、この列を追加し直します。

次の3つのシャードテーブルをマージしてTiDBに移行します。

optimistic-ddl-fail-example-1

tbl01Ageの新しい列を追加し、列のデフォルト値を0に設定します。

ALTER TABLE `tbl01` ADD COLUMN `Age` INT DEFAULT 0;

optimistic-ddl-fail-example-2

tbl00Ageの新しい列を追加し、列のデフォルト値を-1に設定します。

ALTER TABLE `tbl00` ADD COLUMN `Age` INT DEFAULT -1;

optimistic-ddl-fail-example-3

それまでに、 DEFAULT 0DEFAULT -1は互いに互換性がないため、 tbl00Age列は矛盾しています。この状況では、DMはエラーを報告しますが、データの不整合を手動で修正する必要があります。

実装の原則

オプティミスティックモードでは、DM-workerがアップストリームからDDLステートメントを受信した後、更新されたテーブルスキーマをDM-masterに転送します。 DM-workerは、各シャーディングテーブルの現在のスキーマを追跡し、DM-masterは、これらのスキーマを、すべてのシャードテーブルのDMLステートメントと互換性のある複合スキーマにマージします。次に、DMマスターは対応するDDLステートメントをダウンストリームに移行します。 DMLステートメントは、ダウンストリームに直接移行されます。

optimistic-ddl-flow

アップストリームのMySQLにtbl01 tbl00およびtbl02 )があると想定します。これらのシャーディングされたテーブルをマージして、ダウンストリームTiDBのtblテーブルに移行します。次の画像を参照してください。

optimistic-ddl-example-1

アップストリームにLevel列を追加します。

ALTER TABLE `tbl00` ADD COLUMN `Level` INT;

optimistic-ddl-example-2

次に、TiDBはtbl00Level列あり)からDMLステートメントを受け取り、 tbl01およびtbl02テーブル( Level列なし)からDMLステートメントを受け取ります。

optimistic-ddl-example-3

次のDMLステートメントは、変更せずにダウンストリームに移行できます。

UPDATE `tbl00` SET `Level` = 9 WHERE `ID` = 1;
INSERT INTO `tbl02` (`ID`, `Name`) VALUES (27, 'Tony');

optimistic-ddl-example-4

また、 tbl01Level列を追加します。

ALTER TABLE `tbl01` ADD COLUMN `Level` INT;

optimistic-ddl-example-5

この時点で、ダウンストリームにはすでに同じLevel列があるため、DM-masterはテーブルスキーマを比較した後に操作を実行しません。

tbl01Name列をドロップします:

ALTER TABLE `tbl01` DROP COLUMN `Name`;

optimistic-ddl-example-6

次に、ダウンストリームはName列のtbl00およびtbl02からDMLステートメントを受信するため、この列はすぐには削除されません。

同様に、すべてのDMLステートメントは引き続きダウンストリームに移行できます。

INSERT INTO `tbl01` (`ID`, `Level`) VALUES (15, 7);
UPDATE `tbl00` SET `Level` = 5 WHERE `ID` = 5;

optimistic-ddl-example-7

tbl02Level列を追加します。

ALTER TABLE `tbl02` ADD COLUMN `Level` INT;

optimistic-ddl-example-8

それまでに、すべてのシャーディングされたテーブルにはLevel列があります。

Name列をそれぞれtbl00tbl02にドロップします。

ALTER TABLE `tbl00` DROP COLUMN `Name`;
ALTER TABLE `tbl02` DROP COLUMN `Name`;

optimistic-ddl-example-9

それまでに、 Name列はすべてのシャーディングされたテーブルから削除され、ダウンストリームで安全に削除できます。

ALTER TABLE `tbl` DROP COLUMN `Name`;

optimistic-ddl-example-10