TiFlash v6.2 アップグレードガイド

このドキュメントでは、 TiFlash を以前のバージョンから v6.2 にアップグレードするときに注意する必要があるTiFlashモジュールの機能変更と、推奨されるアクションについて説明します。

標準的なアップグレードプロセスについては、次のドキュメントを参照してください。

ノート：
ファストスキャンは実験的機能として v6.2.0 に導入され、v7.0.0 で一般利用可能 (GA) になります。強力なデータ一貫性を犠牲にして、より効率的なクエリパフォーマンスを提供します。
TiFlashを含む TiDB をメジャーバージョン間で (たとえば、v4.x から v6.x に) アップグレードすることはお勧めできません。代わりに、まず v4.x から v5.x にアップグレードし、次に v6.x にアップグレードする必要があります。
v4.x はライフサイクルの終わりに近づいています。できるだけ早く v5.x 以降にアップグレードすることをお勧めします。詳細については、 TiDB リリースサポートポリシーを参照してください。
PingCAP は、v6.0 などの非 LTS バージョンのバグ修正を提供しません。可能な限り、v6.1 以降の LTS バージョンにアップグレードすることをお勧めします。
TiFlash をv5.3.0 より前のバージョンから v5.3.0 以降にアップグレードするには、 TiFlashを停止してからアップグレードする必要があります。次の手順は、他のコンポーネントを中断せずにTiFlashをアップグレードするのに役立ちます。
TiFlashインスタンスを停止します: tiup cluster stop <cluster-name> -R tiflash
TiDB クラスターを再起動せずにアップグレードします (ファイルの更新のみ): tiup cluster upgrade <cluster-name> <version> --offline (例: tiup cluster upgrade <cluster-name> v5.3.0 --offline
TiDB クラスターをリロードします。 tiup cluster reload <cluster-name> .リロード後、 TiFlashインスタンスが開始されるため、手動で開始する必要はありません。

5.x または v6.0 から v6.1

TiFlash をv5.x または v6.0 から v6.1 にアップグレードする場合は、 TiFlashプロキシと動的プルーニングの機能変更に注意してください。

TiFlashプロキシ

TiFlashプロキシは v6.1.0 でアップグレードされます (TiKV v6.0.0 と連携)。新しいバージョンでは、RocksDB のバージョンがアップグレードされました。 TiFlash をv6.1 にアップグレードすると、データ形式が新しいバージョンに自動的に変換されます。

通常のアップグレードでは、データ変換にリスクは伴いません。ただし、特別なシナリオ (テストまたは検証シナリオなど) でTiFlash をv6.1 から以前のバージョンにダウングレードする必要がある場合、以前のバージョンでは新しい RocksDB 構成の解析に失敗する可能性があります。その結果、 TiFlash は再起動できなくなります。アップグレードプロセスを十分にテストおよび検証し、緊急時の計画を準備することをお勧めします。

テストまたはその他の特別なシナリオでTiFlashをダウングレードするための回避策

ターゲットTiFlashノードを強制的にスケールインしてから、TiKV からデータを再度レプリケートできます。詳細な手順については、 TiFlashクラスターでのスケールインを参照してください。

動的枝刈り

動的プルーニングモード有効にせず、今後も使用しない場合は、このセクションをスキップできます。

新しくインストールされた TiDB v6.1.0: 動的プルーニングはデフォルトで有効になっています。
TiDB v6.0 以前: 動的プルーニングはデフォルトで無効になっています。アップグレード後の動的プルーニングの設定は、以前のバージョンの設定を継承します。つまり、動的プルーニングはアップグレード後に自動的に有効 (または無効) になりません。
アップグレード後、動的プルーニングを有効にするには、 tidb_partition_prune_modeからdynamicを設定し、パーティション化されたテーブルの GlobalStats を手動で更新します。詳細は動的プルーニングモードを参照してください。

v5.x または v6.0 から v6.2 へ

TiDB v6.2 では、 TiFlashのデータstorage形式が V3 バージョンにアップグレードされます。したがって、 TiFlash をv5.x または v6.0 から v6.2 にアップグレードする場合は、 TiFlashプロキシと動的枝刈りの機能変更に加えて、PageStorage の機能変更にも注意する必要があります。

ページストレージ

デフォルトでは、 TiFlash v6.2.0 は PageStorage V3 バージョンformat_version = 4を使用します。この新しいデータ形式により、ピーク時の書き込み I/O トラフィックが大幅に削減されます。更新トラフィックが多く、同時実行性が高い、またはクエリが重いシナリオでは、 TiFlashデータ GC によって引き起こされる過剰な CPU 使用率を効果的に軽減します。一方、以前のstorage形式と比較して、V3 バージョンではスペースの拡大とリソースの消費が大幅に削減されます。

v6.2.0 へのアップグレード後、新しいデータが既存のTiFlashノードに書き込まれるため、以前のデータは徐々に新しい形式に変換されます。
ただし、変換には一定量のシステムオーバーヘッドが消費されるため、アップグレード中に以前のデータを新しい形式に完全に変換することはできません (サービスには影響しませんが、注意が必要です)。アップグレード後、 Compactコマンドを実行してデータを新しい形式に変換することをお勧めします。手順は次のとおりです。
1. TiFlashレプリカを含むテーブルごとに次のコマンドを実行します。
```
ALTER TABLE <table_name> COMPACT tiflash replica;
```
2. TiFlashノードを再起動します。

Grafana でテーブルが古いデータ形式をまだ使用しているかどうかを確認できます: TiFlash- Summary > Storage Pool > Storage Pool Run Mode 。

V2 のみ: PageStorage V2 を使用するテーブルの数 (パーティションを含む)
V3 のみ: PageStorage V3 を使用するテーブルの数 (パーティションを含む)
混合モード: PageStorage V2 から PageStorage V3 に変換されたデータ形式のテーブルの数 (パーティションを含む)

テストまたはその他の特別なシナリオでTiFlashをダウングレードするための回避策

v6.1からv6.2へ

TiFlash をv6.1 から v6.2 にアップグレードする場合は、データstorage形式の変更に注意してください。詳細はページストレージを参照してください。

TiFlash v6.2 アップグレード ガイド