アップグレードとアップグレード後のFAQ
このドキュメントでは、TiDB のアップグレード時またはアップグレード後によくある質問とその解決策を紹介します。
アップグレードに関するよくある質問
このセクションでは、TiDB をアップグレードする際の FAQ とその解決策をいくつか示します。
ローリングアップデートの効果は何ですか?
TiDB サービスにローリング アップデートを適用すると、実行中のアプリケーションにさまざまな影響が及ぶため、業務のピーク時にローリング アップデートを実行することはお勧めしません。最小のクラスター トポロジ (TiDB 2、PD 3、TiKV * 3) を構成する必要があります。
DDL 実行中に TiDB クラスターをアップグレードできますか?
アップグレード前の TiDB バージョンが v7.1.0 より前の場合:
クラスター内で DDL ステートメントが実行されているときは、TiDB クラスターをアップグレードしないでください(通常は、
ADD INDEXや列タイプの変更などの時間のかかる DDL ステートメントの場合)。アップグレードの前に、ADMIN SHOW DDLコマンドを使用して、TiDB クラスターに実行中の DDL ジョブがあるかどうかを確認することをお勧めします。クラスターに DDL ジョブがある場合は、クラスターをアップグレードする前に、DDL の実行が完了するまで待つか、ADMIN CANCEL DDLコマンドを使用して DDL ジョブをキャンセルしてください。クラスターのアップグレード中は、DDL ステートメントを実行しないでください。そうしないと、未定義の動作の問題が発生する可能性があります。
アップグレード前の TiDB バージョンが v7.1.0 以降の場合:
- 以前のバージョンから v7.1.0 にアップグレードする場合の制限に従う必要はありません。つまり、TiDB はアップグレード中にユーザー DDL タスクを受け取ることができます。詳細については、 TiDB スムーズアップグレードを参照してください。
バイナリを使用して TiDB をアップグレードするにはどうすればよいですか?
バイナリを使用して TiDB をアップグレードすることは推奨されません。代わりに、バージョンの一貫性と互換性の両方を保証するTiUP を使用して TiDB をアップグレードするまたはKubernetes 上の TiDB クラスターをアップグレードするにアップグレードすることをお勧めします。
アップグレード後のFAQ
このセクションでは、TiDB をアップグレードした後の FAQ とその解決策をいくつか示します。
DDL操作実行時の文字セット（charset）エラー
v2.1.0 以前のバージョン (v2.0 のすべてのバージョンを含む) では、TiDB のデフォルトの文字セットは UTF-8 でした。ただし、v2.1.1 以降では、デフォルトの文字セットは UTF8MB4 に変更されました。
v2.1.0 以前のバージョンで新しく作成されたテーブルの文字セットを UTF-8 として明示的に指定すると、TiDB を v2.1.1 にアップグレードした後に DDL 操作を実行できない可能性があります。
この問題を回避するには、次の点に注意する必要があります。
v2.1.3 より前の TiDB では、列の文字セットの変更はサポートされていません。したがって、DDL 操作を実行するときは、新しい列の文字セットが元の列の文字セットと一致していることを確認する必要があります。
v2.1.3 より前では、列の文字セットがテーブルの文字セットと異なっていても、
show create table列の文字セットが表示されませんでした。しかし、次の例のように、HTTP API 経由でテーブルのメタデータを取得することで表示できるようになります。
unsupported modify column charset utf8mb4 not match origin utf8
アップグレード前に、v2.1.0 以前のバージョンでは以下の操作が実行されます。
create table t(a varchar(10)) charset=utf8;Query OK, 0 rows affected Time: 0.106sshow create table t;+-------+-------------------------------------------------------+ | Table | Create Table | +-------+-------------------------------------------------------+ | t | CREATE TABLE `t` ( | | | `a` varchar(10) DEFAULT NULL | | | ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin | +-------+-------------------------------------------------------+ 1 row in set Time: 0.006sアップグレード後、v2.1.1 および v2.1.2 では次のエラーが報告されますが、v2.1.3 以降のバージョンではこのようなエラーは発生しません。
alter table t change column a a varchar(20);ERROR 1105 (HY000): unsupported modify column charset utf8mb4 not match origin utf8
解決：
列の文字セットを元の文字セットと同じに明示的に指定できます。
alter table t change column a a varchar(22) character set utf8;
ポイント 1 によると、列の文字セットを指定しない場合はデフォルトで UTF8MB4 が使用されるため、元の文字セットと一致するように列の文字セットを指定する必要があります。
ポイント 2 によれば、HTTP API を介してテーブルのメタデータを取得し、列名とキーワード「Charset」を検索することで列の文字セットを見つけることができます。
curl "http://$IP:10080/schema/test/t" | python -m json.toolここでは JSON をフォーマットするために Python ツールが使用されていますが、これは必須ではなく、コメントを追加するための便宜上の目的でのみ使用されています。
{ "ShardRowIDBits": 0, "auto_inc_id": 0, "charset": "utf8", # The charset of the table. "collate": "", "cols": [ # The relevant information about the columns. { ... "id": 1, "name": { "L": "a", "O": "a" # The column name. }, "offset": 0, "origin_default": null, "state": 5, "type": { "Charset": "utf8", # The charset of column a. "Collate": "utf8_bin", "Decimal": 0, "Elems": null, "Flag": 0, "Flen": 10, "Tp": 15 } } ], ... }
unsupported modify charset from utf8mb4 to utf8
アップグレード前に、v2.1.1 および v2.1.2 では以下の操作が実行されます。
create table t(a varchar(10)) charset=utf8;Query OK, 0 rows affected Time: 0.109sshow create table t;+-------+-------------------------------------------------------+ | Table | Create Table | +-------+-------------------------------------------------------+ | t | CREATE TABLE `t` ( | | | `a` varchar(10) DEFAULT NULL | | | ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin | +-------+-------------------------------------------------------+上記の例では、
show create tableテーブルの文字セットのみを示していますが、列の文字セットは実際には UTF8MB4 であり、HTTP API 経由でスキーマを取得することで確認できます。ただし、新しいテーブルが作成されると、列の文字セットはテーブルの文字セットと一致している必要があります。このバグは v2.1.3 で修正されました。アップグレード後、v2.1.3以降のバージョンでは以下の操作が実行されます。
show create table t;+-------+--------------------------------------------------------------------+ | Table | Create Table | +-------+--------------------------------------------------------------------+ | t | CREATE TABLE `t` ( | | | `a` varchar(10) CHARSET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL | | | ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin | +-------+--------------------------------------------------------------------+ 1 row in set Time: 0.007salter table t change column a a varchar(20);ERROR 1105 (HY000): unsupported modify charset from utf8mb4 to utf8
解決：
v2.1.3 以降、TiDB は列とテーブルの文字セットの変更をサポートするため、テーブルの文字セットを UTF8MB4 に変更することをお勧めします。
alter table t convert to character set utf8mb4;問題 1 で行ったように列の文字セットを指定して、元の列の文字セット (UTF8MB4) との一貫性を保つこともできます。
alter table t change column a a varchar(20) character set utf8mb4;
ERROR 1366 (HY000): incorrect utf8 value f09f8c80(🌀) for column a
TiDB v2.1.1 以前のバージョンでは、文字セットが UTF-8 の場合、挿入された 4 バイト データに対して UTF-8 Unicode エンコーディング チェックは行われませんでした。ただし、v2.1.2 以降のバージョンでは、このチェックが追加されました。
アップグレード前に、v2.1.1 以前のバージョンでは以下の操作が実行されます。
create table t(a varchar(100) charset utf8);Query OK, 0 rows affectedinsert t values (unhex('f09f8c80'));Query OK, 1 row affectedアップグレード後、v2.1.2 以降のバージョンでは次のエラーが報告されます。
insert t values (unhex('f09f8c80'));ERROR 1366 (HY000): incorrect utf8 value f09f8c80(🌀) for column a
解決：
v2.1.2: このバージョンでは列の文字セットの変更がサポートされていないため、UTF-8 チェックをスキップする必要があります。
set @@session.tidb_skip_utf8_check=1;Query OK, 0 rows affectedinsert t values (unhex('f09f8c80'));Query OK, 1 row affectedv2.1.3 以降のバージョンでは、列の文字セットを UTF8MB4 に変更することをお勧めします。または、
tidb_skip_utf8_check設定して UTF-8 チェックをスキップすることもできます。ただし、チェックをスキップすると、MySQL がチェックを実行するため、TiDB から MySQL へのデータのレプリケーションに失敗する可能性があります。alter table t change column a a varchar(100) character set utf8mb4;Query OK, 0 rows affectedinsert t values (unhex('f09f8c80'));Query OK, 1 row affected具体的には、変数
tidb_skip_utf8_check使用して、データの UTF-8 および UTF8MB4 の正当なチェックをスキップできます。ただし、チェックをスキップすると、MySQL がチェックを実行するため、TiDB から MySQL へのデータの複製に失敗する可能性があります。UTF-8 チェックのみをスキップしたい場合は、
tidb_check_mb4_value_in_utf8設定できます。この変数は v2.1.3 のconfig.tomlファイルに追加され、設定ファイルでcheck-mb4-value-in-utf8変更してからクラスターを再起動すると有効になります。v2.1.5 以降では、HTTP API とセッション変数を通じて
tidb_check_mb4_value_in_utf8設定できます。HTTP API（HTTP APIは単一のサーバーでのみ有効にできます）
HTTP API を有効にするには:
curl -X POST -d "check_mb4_value_in_utf8=1" http://{TiDBIP}:10080/settingsHTTP API を無効にするには:
curl -X POST -d "check_mb4_value_in_utf8=0" http://{TiDBIP}:10080/settings
セッション変数
セッション変数を有効にするには:
set @@session.tidb_check_mb4_value_in_utf8 = 1;セッション変数を無効にするには:
set @@session.tidb_check_mb4_value_in_utf8 = 0;