TiCDC 互換性
このセクションでは、TiCDC に関連する互換性の問題とその処理方法について説明します。
CLIと設定ファイルの互換性
- TiCDC v4.0.0 では、
ignore-txn-commit-tsが削除され、start_ts を使用してトランザクションをフィルター処理するignore-txn-start-tsが追加されました。 - TiCDC v4.0.2 では、
db-dbs/db-tables/ignore-dbs/ignore-tablesが削除され、データベースとテーブルに新しいフィルター ルールを使用するrulesが追加されました。詳細なフィルター構文については、 テーブルフィルターを参照してください。 - TiCDC v6.2.0 以降では、
cdc cli--serverOpen API を介して TiCDCサーバーと直接対話できます。3 パラメータを使用して TiCDCサーバーのアドレスを指定できます。5--pd非推奨です。 - v6.4.0 以降では、権限
SYSTEM_VARIABLES_ADMINまたはSUPERを持つ changefeed のみが TiCDC Syncpoint 機能を使用できます。
互換性の問題に対処する
このセクションでは、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ツールを使用して作成された changefeed を削除します。たとえば、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 cliv5.0.0-rc の場合にのみ発生します。3 他の v5.0.x バージョンのcdc cliは、v4.0.x クラスターと互換性があります。
sort-dirとdata-dirの互換性に関する注意事項
sort-dir構成は、TiCDC ソーターの一時ファイル ディレクトリを指定するために使用されます。その機能はバージョンによって異なる場合があります。次の表は、バージョン間でのsort-dirの互換性の変更を示しています。
| バージョン | sort-engine機能 | 注記 | おすすめ |
|---|---|---|---|
| v4.0.11 またはそれ以前の v4.0 バージョン、v5.0.0-rc | これは、changefeed 構成項目であり、 fileソーターとunifiedソーターの一時ファイル ディレクトリを指定します。 | これらのバージョンでは、 fileソーターとunifiedソーターは実験的機能であり、本番環境には推奨されません。複数の changefeed が unifiedソーターをsort-engineとして使用する場合、実際の一時ファイル ディレクトリはいずれかの changefeed のsort-dir構成になる可能性があり、各 TiCDC ノードに使用されるディレクトリは異なる場合があります。 | 本番環境でunifiedソーターを使用することは推奨されません。 |
| v4.0.12、v4.0.13、v5.0.0、および v5.0.1 | これは changefeed またはcdc serverの構成項目です。 | デフォルトでは、 changefeed のsort-dir構成は有効にならず、 cdc serverのsort-dir構成はデフォルトで/tmp/cdc_sortになります。本番環境ではcdc serverのみを構成することをお勧めします。TiUPを使用して TiCDC を展開する場合は、最新のTiUPバージョンを使用し、TiCDCサーバー構成で sorter.sort-dirを設定することをお勧めします。unifiedソーターは、v4.0.13、v5.0.0、v5.0.1 ではデフォルトで有効になっています。クラスターをこれらのバージョンにアップグレードする場合は、TiCDCサーバー構成でsorter.sort-dirが正しく構成されていることを確認してください。 | cdc serverコマンドラインパラメータ (またはTiUP) を使用してsort-dir構成する必要があります。 |
| v4.0.14 以降の v4.0 バージョン、v5.0.3 以降の v5.0 バージョン、それ以降の TiDB バージョン | sort-dirは非推奨です。 data-dirを設定することをお勧めします。 | 最新バージョンのTiUPを使用してdata-dir設定できます。これらの TiDB バージョンでは、 unifiedソーターがデフォルトで有効になっています。クラスターをアップグレードするときに、 data-dirが正しく設定されていることを確認してください。そうでない場合、一時ファイル ディレクトリとしてデフォルトで/tmp/cdc_data使用されます。ディレクトリが配置されているデバイスのstorage容量が不足している場合、ハードディスク容量不足の問題が発生する可能性があります。この場合、changefeed の以前の sort-dir構成は無効になります。 | cdc serverコマンドラインパラメータ (またはTiUP) を使用してdata-dir構成する必要があります。 |
| v6.0.0以降のバージョン | data-dir 、TiCDC によって生成された一時ファイルを保存するために使用されます。 | v6.0.0 以降、TiCDC はデフォルトでソート エンジンとしてdb sorter使用します。3 data-dirこのエンジンのディスク ディレクトリです。 | cdc serverコマンドラインパラメータ (またはTiUP) を使用してdata-dir構成する必要があります。 |
一時テーブルとの互換性
v5.3.0 以降、TiCDC はグローバル一時テーブルサポートします。v5.3.0 より前のバージョンの TiCDC を使用してグローバル一時テーブルをダウンストリームに複製すると、テーブル定義エラーが発生します。
アップストリーム クラスターにグローバル一時テーブルが含まれている場合、ダウンストリーム TiDB クラスターは v5.3.0 以降のバージョンである必要があります。それ以外の場合、レプリケーション プロセス中にエラーが発生します。