重要

現在表示されているページは、TiDBのアーカイブされたドキュメント (非更新) です。TiDBをご利用の場合、最新のLTS (Long Term Support) バージョンの使用を推奨します。

重要

このページは英語版のページを機械翻訳しています。原文はこちらからご覧ください。

TiUP を使用して TiDB をアップグレードする

このドキュメントは、次のアップグレードパスを対象としています。

TiDB 4.0 バージョンから TiDB 6.3 にアップグレードします。
TiDB 5.0 ～ 5.4 バージョンから TiDB 6.3 にアップグレードします。
TiDB 6.0 から TiDB 6.3 にアップグレードします。
TiDB 6.1 から TiDB 6.3 にアップグレードします。
TiDB 6.2 から TiDB 6.3 にアップグレードします。

警告

TiFlash を 5.3 より前のバージョンから 5.3 以降にオンラインでアップグレードすることはできません。代わりに、最初に初期バージョンのすべての TiFlash インスタンスを停止してから、クラスターをオフラインでアップグレードする必要があります。他のコンポーネント (TiDB や TiKV など) がオンラインアップグレードをサポートしていない場合は、オンラインアップグレードの警告の指示に従ってください。
DDL ステートメントがクラスターで実行されているときは、 TiDBクラスターをアップグレードしないでください (通常、 ADD INDEXのような時間のかかる DDL ステートメントや列の型の変更のため)。
アップグレードの前に、 ADMIN SHOW DDLコマンドを使用して、TiDB クラスターに進行中の DDL ジョブがあるかどうかを確認することをお勧めします。クラスターに DDL ジョブがある場合、クラスターをアップグレードするには、DDL の実行が完了するまで待つか、 ADMIN CANCEL DDLコマンドを使用して DDL ジョブをキャンセルしてからクラスターをアップグレードします。
また、クラスターのアップグレード中は、DDL ステートメントを実行しないでください。そうしないと、未定義の動作の問題が発生する可能性があります。

ノート：
アップグレードするクラスターが v3.1 以前のバージョン (v3.0 または v2.1) である場合、v6.3.0 への直接アップグレードはサポートされていません。最初にクラスターを v4.0 にアップグレードし、次に v6.3.0 にアップグレードする必要があります。

アップグレードの注意事項

TiDB は現在、バージョンのダウングレードまたはアップグレード後の以前のバージョンへのロールバックをサポートしていません。
TiDB Ansible を使用して管理されている v4.0 クラスターの場合、 TiUP (v4.0) を使用して TiDB をアップグレードするに従って新しい管理のためにクラスターを TiUP ( tiup cluster ) にインポートする必要があります。その後、このドキュメントに従ってクラスターを v6.3.0 にアップグレードできます。
v3.0 より前のバージョンを v6.3.0 に更新するには:
1. TiDB アンシブルを使用して、このバージョンを 3.0 に更新します。
2. TiUP ( tiup cluster ) を使用して、TiDB Ansible 構成をインポートします。
3. TiUP (v4.0) を使用して TiDB をアップグレードするに従って、バージョン 3.0 を 4.0 に更新します。
4. このドキュメントに従って、クラスターを v6.3.0 にアップグレードします。
TiDB Binlog、TiCDC、TiFlash、およびその他のコンポーネントのバージョンのアップグレードをサポートします。
異なるバージョンの詳細な互換性の変更については、各バージョンのリリースノートを参照してください。対応するリリースノートの「互換性の変更」セクションに従って、クラスター構成を変更します。
v5.3 より前のバージョンから v5.3 以降のバージョンにアップグレードするクラスターの場合、デフォルトでデプロイされた Prometheus は v2.8.1 から v2.27.1 にアップグレードされます。 Prometheus v2.27.1 は、より多くの機能を提供し、セキュリティの問題を修正します。 v2.8.1 と比較して、v2.27.1 のアラート時間の表現が変更されました。詳細については、プロメテウスコミットを参照してください。

準備

このセクションでは、TiUP および TiUPクラスタコンポーネントのアップグレードを含め、TiDB クラスターをアップグレードする前に必要な準備作業を紹介します。

手順 1: TiUP または TiUP オフラインミラーをアップグレードする

TiDB クラスターをアップグレードする前に、まず TiUP または TiUP ミラーをアップグレードする必要があります。

TiUP および TiUPクラスタのアップグレード

ノート：
アップグレードするクラスタの制御マシンがhttps://tiup-mirrors.pingcap.comにアクセスできない場合は、このセクションをスキップしてTiUP オフラインミラーのアップグレードを参照してください。

TiUPのバージョンアップ。 TiUPのバージョンは1.11.0以降を推奨します。
```
tiup update --self
tiup --version
```
TiUPクラスタのバージョンをアップグレードします。 TiUP クラスタのバージョンは1.11.0以降を推奨します。
```
tiup update cluster
tiup cluster --version
```

TiUP オフラインミラーのアップグレード

ノート：
アップグレードするクラスターがオフラインの方法を使用せずにデプロイされた場合は、この手順をスキップしてください。

TiUP を使用して TiDBクラスタをデプロイする - TiUP をオフラインでデプロイを参照して、新しいバージョンの TiUP ミラーをダウンロードし、制御マシンにアップロードします。 local_install.shを実行すると、TiUP は上書きアップグレードを完了します。

tar xzvf tidb-community-server-${version}-linux-amd64.tar.gz
sh tidb-community-server-${version}-linux-amd64/local_install.sh
source /home/tidb/.bash_profile

上書きアップグレードの後、次のコマンドを実行して、サーバーとツールキットのオフラインミラーをサーバーディレクトリにマージします。

tar xf tidb-community-toolkit-${version}-linux-amd64.tar.gz
ls -ld tidb-community-server-${version}-linux-amd64 tidb-community-toolkit-${version}-linux-amd64
cd tidb-community-server-${version}-linux-amd64/
cp -rp keys ~/.tiup/
tiup mirror merge ../tidb-community-toolkit-${version}-linux-amd64

ミラーをマージした後、次のコマンドを実行して TiUP クラスタコンポーネントをアップグレードします。

tiup update cluster

これで、オフラインミラーが正常にアップグレードされました。上書き後のTiUP操作でエラーが発生した場合、 manifestが更新されていない可能性があります。 TiUP を再度実行する前にrm -rf ~/.tiup/manifests/*を試すことができます。

手順 2: TiUP トポロジ構成ファイルを編集する

ノート：
次のいずれかの状況に該当する場合は、この手順をスキップしてください。
元のクラスターの構成パラメーターを変更していません。または、 tiup clusterを使用して構成パラメーターを変更しましたが、それ以上の変更は必要ありません。
アップグレード後、変更されていない構成アイテムに対して v6.3.0 のデフォルトのパラメーター値を使用したいと考えています。

vi編集モードに入り、トポロジファイルを編集します。
```
tiup cluster edit-config <cluster-name>
```
トポロジー構成テンプレートのフォーマットを参照し、変更するパラメーターをトポロジーファイルのserver_configsセクションに入力します。
変更後、 : + w + qを入力して変更を保存し、編集モードを終了します。 Yを入力して変更を確認します。

ノート：
クラスターを v6.3.0 にアップグレードする前に、v4.0 で変更したパラメーターが v6.3.0 で互換性があることを確認してください。詳細については、 TiKVConfiguration / コンフィグレーションファイルを参照してください。
次の 3 つの TiKV パラメータは、TiDB v5.0 で廃止されました。元のクラスターで次のパラメーターが構成されている場合は、これらのパラメーターをedit-configから削除する必要があります。
ペシミスティック-txn.enabled
サーバー.request-batch-enable-cross-command
サーバー.request-batch-wait-duration

ステップ 3: 現在のクラスターのヘルスステータスを確認する

アップグレード中の未定義の動作やその他の問題を回避するには、アップグレード前に現在のクラスターのリージョンのヘルスステータスを確認することをお勧めします。これを行うには、 checkサブコマンドを使用できます。

tiup cluster check <cluster-name> --cluster

コマンド実行後、「リージョンの状態」チェック結果が出力されます。

結果が「すべてのリージョンが正常」である場合、現在のクラスター内のすべてのリージョンは正常であり、アップグレードを続行できます。
結果が「リージョンが完全に正常ではありません: m miss-peer、n pending-peer」の場合、「他の操作の前に異常なリージョンを修正してください」。現在のクラスターの一部のリージョンが異常です。チェック結果が「すべてのリージョンが正常」になるまで、異常をトラブルシューティングする必要があります。その後、アップグレードを続行できます。

TiDB クラスターをアップグレードする

このセクションでは、TiDB クラスターをアップグレードし、アップグレード後にバージョンを確認する方法について説明します。

TiDB クラスターを指定されたバージョンにアップグレードする

クラスタは、オンラインアップグレードとオフラインアップグレードの 2 つの方法のいずれかでアップグレードできます。

デフォルトでは、TiUPクラスタはオンライン方式を使用して TiDB クラスターをアップグレードします。これは、TiDB クラスターがアップグレードプロセス中にサービスを提供できることを意味します。オンライン方式では、リーダーはアップグレードと再起動の前に各ノードで 1 つずつ移行されます。したがって、大規模なクラスターの場合、アップグレード操作全体を完了するには長い時間がかかります。

メンテナンスのためにデータベースを停止するメンテナンスウィンドウがアプリケーションにある場合は、オフラインアップグレード方法を使用して、アップグレード操作をすばやく実行できます。

オンラインアップグレード

tiup cluster upgrade <cluster-name> <version>

たとえば、クラスターを v6.3.0 にアップグレードする場合:

tiup cluster upgrade <cluster-name> v6.3.0

ノート：
オンラインアップグレードでは、すべてのコンポーネントが 1 つずつアップグレードされます。 TiKV のアップグレード中、TiKV インスタンス内のすべてのリーダーは、インスタンスを停止する前に削除されます。デフォルトのタイムアウト時間は 5 分 (300 秒) です。このタイムアウト時間が経過すると、インスタンスは直接停止されます。
--forceパラメーターを使用して、リーダーを削除せずにすぐにクラスターをアップグレードできます。ただし、アップグレード中に発生するエラーは無視されます。つまり、アップグレードの失敗は通知されません。したがって、 --forceパラメータは注意して使用してください。
安定したパフォーマンスを維持するには、インスタンスを停止する前に、TiKV インスタンス内のすべてのリーダーが削除されていることを確認してください。 --transfer-timeoutを--transfer-timeout 3600 (単位: 秒) など、より大きな値に設定できます。
TiFlash を 5.3 より前のバージョンから 5.3 以降にアップグレードするには、TiFlash を停止してからアップグレードする必要があります。次の手順は、他のコンポーネントを中断することなく TiFlash をアップグレードするのに役立ちます。
TiFlash インスタンスを停止します: tiup cluster stop <cluster-name> -R tiflash
再起動せずに TiDB クラスターをアップグレードします (ファイルの更新のみ): tiup cluster upgrade <cluster-name> <version> --offline
TiDB クラスターをリロードします。 tiup cluster reload <cluster-name> .リロード後、TiFlash インスタンスが開始されるため、手動で開始する必要はありません。

オフラインアップグレード

オフラインアップグレードの前に、まずクラスター全体を停止する必要があります。
```
tiup cluster stop <cluster-name>
```
upgradeコマンドと--offlineオプションを使用して、オフラインアップグレードを実行します。
```
tiup cluster upgrade <cluster-name> <version> --offline
```
アップグレード後、クラスターは自動的に再起動されません。 startコマンドを使用して再起動する必要があります。
```
tiup cluster start <cluster-name>
```

クラスターのバージョンを確認する

displayコマンドを実行して、最新のクラスターバージョンTiDB Versionを表示します。

tiup cluster display <cluster-name>

Cluster type:       tidb
Cluster name:       <cluster-name>
Cluster version:    v6.3.0

ノート：
デフォルトでは、TiUP と TiDB は使用状況の詳細を PingCAP と共有して、製品の改善方法を理解できるようにします。共有される内容と共有を無効にする方法の詳細については、テレメトリーを参照してください。

FAQ

このセクションでは、TiUP を使用して TiDB クラスターを更新するときに発生する一般的な問題について説明します。

エラーが発生してアップグレードが中断された場合、このエラーを修正した後にアップグレードを再開するにはどうすればよいですか?

tiup cluster upgradeコマンドを再実行して、アップグレードを再開します。アップグレード操作により、以前にアップグレードされたノードが再起動されます。アップグレードしたノードを再起動したくない場合は、 replayサブコマンドを使用して操作を再試行します。

tiup cluster auditを実行して操作記録を表示します。
```
tiup cluster audit
```
失敗したアップグレード操作レコードを見つけて、この操作レコードの ID を保持します。 ID は、次のステップの<audit-id>の値です。
tiup cluster replay <audit-id>を実行して、対応する操作を再試行します。
```
tiup cluster replay <audit-id>
```

エビクトリーダーは、アップグレード中に長時間待機しました。迅速なアップグレードのためにこの手順をスキップするにはどうすればよいですか?

--forceを指定できます。その後、PD リーダーの転送と TiKV リーダーの削除のプロセスは、アップグレード中にスキップされます。クラスターを直接再起動してバージョンを更新するため、オンラインで実行されるクラスターに大きな影響を与えます。コマンドは次のとおりです。

tiup cluster upgrade <cluster-name> <version> --force

TiDB クラスターをアップグレードした後、pd-ctl などのツールのバージョンを更新する方法を教えてください。

TiUP を使用して、対応するバージョンのctlつのコンポーネントをインストールすることで、ツールのバージョンをアップグレードできます。

tiup install ctl:v6.3.0

TiDB 6.3.0 の互換性の変更

互換性の変更については、TiDB 6.3.0 リリースノートを参照してください。
TiDB Binlogを使用してクラスターにローリング更新を適用するときは、新しいクラスター化インデックステーブルを作成しないようにしてください。