双方向レプリケーション

TiCDCは、2つのTiDBクラスタ間の双方向レプリケーション（BDR）をサポートしています。この機能を利用することで、TiCDCを使用したマルチアクティブTiDBソリューションを構築できます。

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

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

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

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

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

DDLタイプ

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

複製可能なDDL

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

レプリケート可能な DDL には次のものが含まれます。

ALTER TABLE ... ADD COLUMN : 列はnullになるか、 not nullとdefault value同時に存在する
ALTER TABLE ... ADD INDEX （一意ではない）
ALTER TABLE ... ADD PARTITION
ALTER TABLE ... ALTER COLUMN DROP DEFAULT
ALTER TABLE ... ALTER COLUMN SET DEFAULT
ALTER TABLE ... COMMENT=...
ALTER TABLE ... DROP PRIMARY KEY
ALTER TABLE ... MODIFY COLUMN : 列のdefault valueとcommentのみ変更できます
ALTER TABLE ... RENAME INDEX
ALTER TABLE ... ALTER INDEX ... INVISIBLE
ALTER TABLE ... ALTER INDEX ... VISIBLE
ALTER TABLE REMOVE TTL
ALTER TABLE TTL
CREATE DATABASE
CREATE INDEX
CREATE TABLE
CREATE VIEW
DROP INDEX
DROP VIEW

複製不可能なDDL

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

レプリケートできない DDL には次のものが含まれます。

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

DDLレプリケーション

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

PRIMARY : レプリケート可能なDDLは実行できますが、レプリケート不可能なDDLは実行できません。プライマリクラスターで実行されたレプリケート可能なDDLは、TiCDCによってダウンストリームにレプリケートされます。
SECONDARY : レプリケート可能なDDLもレプリケート不可能なDDLも実行できません。ただし、プライマリクラスターで実行されたDDLは、TiCDCによってセカンダリクラスターにレプリケートできます。

BDRロールが設定されていない場合、任意のDDLを実行できます。ただし、BDRモードの変更フィードでは、そのクラスター上のDDLはレプリケートされません。

つまり、BDR モードでは、TiCDC は PRIMARY クラスター内の複製可能な DDL のみをダウンストリームに複製します。

複製可能な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を手動で実行する必要があります。