双方向レプリケーション

TiCDC は、2 つの TiDB クラスター間の双方向レプリケーション (BDR) をサポートします。この機能に基づいて、TiCDC を使用してマルチアクティブ TiDB ソリューションを作成できます。

このセクションでは、2 つの TiDB クラスターを例に、双方向レプリケーションを使用する方法について説明します。

双方向レプリケーションをデプロイ

TiCDC は、指定されたタイムスタンプの後に発生した増分データ変更のみをダウンストリームクラスターに複製します。双方向レプリケーションを開始する前に、次の手順を実行する必要があります。

(オプション) 必要に応じて、データエクスポートツールDumplingとデータインポートツールTiDB Lightningを使用して、2 つの TiDB クラスターのデータを相互にインポートします。
2 つの TiDB クラスターの間に 2 つの TiCDC クラスターをデプロイ。クラスタートポロジは次のようになります。図の矢印はデータフローの方向を示します。
アップストリームクラスターとダウンストリームクラスターのデータレプリケーションの開始時点を指定します。
1. 上流クラスターと下流クラスターの時点を確認します。2 つの TiDB クラスターの場合は、特定の時点で 2 つのクラスターのデータが一致していることを確認します。たとえば、 ts=1の TiDB A のデータとts=2の TiDB B のデータは一致しています。
2. changefeed を作成するときは、上流クラスターの changefeed の--start-tsを対応するtsoに設定します。つまり、上流クラスターが TiDB A の場合は--start-ts=1設定し、上流クラスターが TiDB B の場合は--start-ts=2設定します。
--configパラメータで指定された構成ファイルに、次の構成を追加します。
```
# Whether to enable the bi-directional replication mode
bdr-mode = true
```

構成が有効になると、クラスターは双方向のレプリケーションを実行できるようになります。

DDL タイプ

v7.6.0 以降、双方向レプリケーションで DDL レプリケーションを可能な限りサポートするために、TiDB は、DDL がビジネスに与える影響に応じて、 TiCDCが元々サポートしていたDDLをレプリケート可能な DDL とレプリケート不可能な DDL の 2 種類に分割します。

複製可能な DDL

レプリケート可能な DDL は、直接実行して双方向レプリケーションで他の TiDB クラスターにレプリケートできる DDL です。

複製可能な DDL には次のものが含まれます。

CREATE DATABASE
CREATE TABLE
ADD COLUMN : 列はnullになるか、 not nullとdefault value同時に存在する
ADD NON-UNIQUE INDEX
DROP INDEX
MODIFY COLUMN : 列のdefault valueとcommentのみ変更できます
ALTER COLUMN DEFAULT VALUE
MODIFY TABLE COMMENT
RENAME INDEX
ADD TABLE PARTITION
DROP PRIMARY KEY
ALTER TABLE INDEX VISIBILITY
ALTER TABLE TTL
ALTER TABLE REMOVE TTL
CREATE VIEW
DROP VIEW

複製不可能な DDL

複製不可能な DDL は、ビジネスに大きな影響を与え、クラスター間でデータの不整合を引き起こす可能性のある DDL です。複製不可能な DDL は、TiCDC を介した双方向レプリケーションで他の TiDB クラスターに直接複製することはできません。複製不可能な DDL は、特定の操作を通じて実行する必要があります。

複製不可能な DDL には次のものが含まれます。

DROP DATABASE
DROP TABLE
ADD COLUMN : 列はnot nullでdefault valueありません
DROP COLUMN
ADD UNIQUE INDEX
TRUNCATE TABLE
MODIFY COLUMN : default valueとcomment除く列の属性を変更できます
RENAME TABLE
DROP PARTITION
TRUNCATE PARTITION
ALTER TABLE CHARACTER SET
ALTER DATABASE CHARACTER SET
RECOVER TABLE
ADD PRIMARY KEY
REBASE AUTO ID
EXCHANGE PARTITION
REORGANIZE PARTITION

DDLレプリケーション

複製可能な DDL と複製不可能な DDL の問題を解決するために、TiDB は次の BDR ロールを導入します。

PRIMARY : レプリケート可能な DDL は実行できますが、レプリケート不可能な DDL は実行できません。レプリケート可能な DDL は、TiCDC によってダウンストリームにレプリケートされます。
SECONDARY : レプリケート可能な DDL またはレプリケート不可能な DDL は実行できませんが、TiCDC によってレプリケートされた DDL は実行できます。

BDR ロールが設定されていない場合は、任意の DDL を実行できます。ただし、TiCDC でbdr_mode=true設定すると、実行された DDL は TiCDC によってレプリケートされなくなります。

警告

この機能は実験的です。本番環境での使用は推奨されません。この機能は予告なしに変更または削除される可能性があります。バグを見つけた場合は、GitHub で問題を報告できます。

複製可能な DDL のレプリケーションシナリオ

TiDB クラスターを選択し、 ADMIN SET BDR ROLE PRIMARY実行してそれをプライマリクラスターとして設定します。

ADMIN SET BDR ROLE PRIMARY;
Query OK, 0 rows affected
Time: 0.003s

ADMIN SHOW BDR ROLE;
+----------+
| BDR_ROLE |
+----------+
| primary  |
+----------+

他の TiDB クラスターでは、 ADMIN SET BDR ROLE SECONDARY実行してそれらをセカンダリクラスターとして設定します。
プライマリクラスターで複製可能な DDLを実行します。正常に実行された DDL は、TiCDC によってセカンダリクラスターに複製されます。

注記：
不正使用を防ぐために：
プライマリクラスターで複製不可能な DDL を実行しようとすると、エラー 8263返されます。
セカンダリクラスターでレプリケート可能な DDLまたはレプリケート不可能な DDL を実行しようとすると、エラー 8263が返されます。

複製不可能な DDL の複製シナリオ

すべての TiDB クラスターでADMIN UNSET BDR ROLE実行して、BDR ロールを設定解除します。
すべてのクラスターで DDL を実行する必要があるテーブルへのデータの書き込みを停止します。
すべてのクラスター内の対応するテーブルへのすべての書き込みが他のクラスターに複製されるまで待機し、各 TiDB クラスターですべての DDL を手動で実行します。
DDL が完了するまで待ってから、データの書き込みを再開します。
複製可能な DDL のレプリケーションシナリオの手順に従って、レプリケート可能な DDL のレプリケーションシナリオに戻ります。

警告

すべての TiDB クラスターでADMIN UNSET BDR ROLE実行すると、TiCDC によって DDL はレプリケートされません。各クラスターで個別に DDL を手動で実行する必要があります。