アップグレードとアップグレード後のFAQ
このドキュメントでは、TiDB のアップグレード時またはアップグレード後によくある質問とその解決策を紹介します。
アップグレードに関するよくある質問
このセクションでは、TiDB をアップグレードする際の FAQ とその解決策をいくつか示します。
ローリングアップデートの効果は何ですか?
TiDBサービスにローリングアップデートを適用すると、実行中のアプリケーションに様々な影響が生じます。そのため、業務のピーク時間帯にローリングアップデートを実行することは推奨されません。最小限のクラスタトポロジ（TiDB 2、PD 3、TiKV * 3）を構成する必要があります。クラスタにPumpサービスまたはDrainerサービスが含まれている場合は、ローリングアップデートを実行する前にDrainerを停止することをお勧めします。TiDBをアップグレードすると、 Pumpもアップグレードされます。
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 とその解決策をいくつか示します。
TiDBのアップグレード後にJDBC接続の照合順序が変更される
以前のバージョンからv7.4以降にアップグレードする際、JDBC URLでconnectionCollationが設定されておらず、かつcharacterEncodingが設定されていないかUTF-8に設定されている場合、アップグレード後にJDBC接続のデフォルトの照合順序がutf8mb4_binからutf8mb4_0900_ai_ciに変更される可能性があります。照合順序をutf8mb4_binに維持する必要がある場合は、JDBC URLでconnectionCollation=utf8mb4_bin設定してください。
詳細についてはJDBC接続で使用される照合順序参照してください。
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に変更することをお勧めします。または、UTF-8チェックをスキップするには
tidb_skip_utf8_check設定します。ただし、チェックをスキップすると、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;