TiCDC の互換性
このセクションでは、TiCDC に関連する互換性の問題とその処理方法について説明します。
CLI と構成ファイルの互換性
- TiCDC v4.0.0 では、
ignore-txn-commit-tsが削除され、ignore-txn-start-tsが追加され、start_ts を使用してトランザクションをフィルタリングします。 - TiCDC v4.0.2 では、
db-dbs/db-tables/ignore-dbs/ignore-tablesが削除され、データベースとテーブルに新しいフィルター ルールを使用するrulesが追加されました。詳細なフィルター構文については、 テーブル フィルターを参照してください。 - TiCDC v6.2.0 から、TiCDC Open API を介して TiCDCサーバーと直接対話できるようになり
cdc cliた。--serverパラメータを使用して、TiCDCサーバーのアドレスを指定できます。--pdは非推奨です。 - v6.4.0 以降、TiCDC Syncpoint 機能を使用できるのは、
SYSTEM_VARIABLES_ADMINまたはSUPER特権を持つ changefeed のみです。
互換性の問題を処理する
このセクションでは、TiCDC に関連する互換性の問題とその処理方法について説明します。
TiCDC v5.0.0-rc cdc cliツールを使用して v4.0.x クラスターを操作することによって引き起こされる非互換性の問題
TiCDC v5.0.0-rc のcdc cliツールを使用して v4.0.x の TiCDC クラスターを操作すると、次の異常な状況が発生する場合があります。
TiCDC クラスターが v4.0.8 以前のバージョンである場合、v5.0.0-rc
cdc cliツールを使用してレプリケーション タスクを作成すると、クラスターの異常が発生し、レプリケーション タスクがスタックする可能性があります。TiCDC クラスターが v4.0.9 以降のバージョンの場合、v5.0.0-rc
cdc cliツールを使用してレプリケーション タスクを作成すると、古い値と統合ソーター機能が予期せずデフォルトで有効になります。
ソリューション:
TiCDC クラスターのバージョンに対応するcdc実行可能ファイルを使用して、次の操作を実行します。
- v5.0.0-rc
cdc cliツールを使用して作成された変更フィードを削除します。たとえば、tiup cdc:v4.0.9 cli changefeed remove -c xxxx --pd=xxxxx --forceコマンドを実行します。 - レプリケーション タスクがスタックしている場合は、TiCDC クラスターを再起動します。たとえば、
tiup cluster restart <cluster_name> -R cdcコマンドを実行します。 - 変更フィードを再作成します。たとえば、
tiup cdc:v4.0.9 cli changefeed create --sink-uri=xxxx --pd=xxxコマンドを実行します。
ノート：
この問題は、
cdc cliが v5.0.0-rc の場合にのみ発生します。他の v5.0.x バージョンのcdc cliツールは、v4.0.x クラスターと互換性があります。
sort-dirとdata-dirの互換性に関する注意事項
sort-dir構成は、TiCDC ソーターの一時ファイル ディレクトリを指定するために使用されます。その機能は、バージョンによって異なる場合があります。次の表は、バージョン間のsort-dirの互換性の変更を示しています。
一時テーブルとの互換性
v5.3.0 以降、TiCDC はグローバル一時テーブルをサポートしています。 v5.3.0 より前のバージョンの TiCDC を使用してグローバル一時テーブルをダウンストリームに複製すると、テーブル定義エラーが発生します。
アップストリーム クラスターにグローバル一時テーブルが含まれている場合、ダウンストリーム TiDB クラスターは v5.3.0 以降のバージョンであると予想されます。そうしないと、レプリケーション プロセス中にエラーが発生します。