MySQLのテーブル名に、日本語を利用した際の計算方法について

Question

本文

こんにちは。MySQLのテーブル名最大長について質問させていただきたいです。

わからないこと

• MySQL のテーブル名の byte 数計算方法
  • 日本語テキストでテーブル名を入力した際、50 文字までは作成できるが、51 文字以降だとエラーが発生する

前提

• 文字コードは UTF8mb4
• MySQL8.0 利用
• テーブル名には、「あ」を使用
• OS は Mac、Windows10 ともに確認

試したこと

• postgres を利用して、日本語テーブル名を入力したところ、接頭辞 21 文字までで切り取られる
  • postgres は テーブル最大長 63 Byte / 日本語 UTF8 3 Byte = 21 という計算が利用されている

最後に

テーブル名に日本語をつけることに対しての意見ではなく、なぜMySQLだと50文字程度格納できるのか、その計算式はどのようになっているのか、を教えていただける方をベストアンサーとさせていただきます。

Comments

[hiroki-o]

MySQL 8.0.33で確認
UTF-8 1byteは、64文字までOK、65文字はエラー(Identifier name '～' is too long)
UTF-8 2～4byteは、50文字までOK、51文字はエラー('Unknown (generic) error from engine' from storage engine)
(↑日本語に限らず)
仕様は、64文字まで。(https://dev.mysql.com/doc/refman/8.2/en/identifier-length.html)
ソースをざっと見た感じでは、わかりませんでした。(https://github.com/mysql/mysql-server)

[ikedas]

一応オペレーティングシステムの名前も記しておいていただけますか。ファイルシステムの制限が関係するかもしれないので。

[hiroki-o]

私が確認した環境は、FreeBSD 13.2です。

[ikedas]

@hiroki-o ありがとうございます。ufsでもファイル名の長さの上限は255バイトのようですね。

[yambejp]

> テーブル名に日本語をつけることに対しての意見ではなく

典型的な特殊なことをやって自力で解決できないのであれば、その特殊なこと（＝日本語のファイル名をつける）はやめたほうがいいという案件です

Answer 1

結論から言うと、ストレージエンジンの仕様による制限だと思われます。オペレーティングシステムの制限も関係すると考えられます。

以下を確認しました。

• macOS Ventura 13.6.3 (M2)
• MySQL 8.0.35
• InnoDB

平仮名65文字:

mysql> create table ああああああああああいいいいいいいいいいううううううううううええええええええええおおおおおおおおおおああああああああああいいいいい (a int);
ERROR 1103 (42000): Incorrect table name 'ああああああああああいいいいいいいいいいううううううううううえええ?'

識別子名の長さ制限 (64文字) に引っ掛かります (エラーメッセージのテーブル名が変なところで切り詰められていますが)。

平仮名64文字 - 51文字

mysql> create table `ああああああああああいいいいいいいいいいううううううううううええええええええええおおおおおおおおおおああああああああああいいいい` (a int);
ERROR 1030 (HY000): Got error 168 - 'Unknown (generic) error from engine' from storage engine
...
mysql> create table `ああああああああああいいいいいいいいいいううううううううううええええええええええおおおおおおおおおおあ` (a int);
ERROR 1030 (HY000): Got error 168 - 'Unknown (generic) error from engine' from storage engine

MySQL自身も知らない (なんだそりゃ) ストレージエンジンのエラーで失敗します。

平仮名50文字

mysql> create table `ああああああああああいいいいいいいいいいううううううううううええええええええええおおおおおおおおおお` (a int);
Query OK, 0 rows affected (0.01 sec)

成功します。

平仮名50文字 と 英字

mysql> create table `ああああああああああいいいいいいいいいいううううううううううええええええええええおおおおおおおおおおaa` (a int);
ERROR 1030 (HY000): Got error 168 - 'Unknown (generic) error from engine' from storage engine
mysql> create table `ああああああああああいいいいいいいいいいううううううううううええええええええええおおおおおおおおおおa` (a int);
Query OK, 0 rows affected (0.01 sec)

英字1文字の追加までは成功します。

作成されたテーブルファイルは次のようなものです。

% ls /opt/homebrew/var/mysql/test
@3042@3042@3042@3042@3042@3042@3042@3042@3042@3042@3044@3044@3044@3044@3044@3044@3044@3044@3044@3044@3046@3046@3046@3046@3046@3046@3046@3046@3046@3046@3048@3048@3048@3048@3048@3048@3048@3048@3048@3048@304a@304a@304a@304a@304a@304a@304a@304a@[e-mail]
@3042@3042@3042@3042@3042@3042@3042@3042@3042@3042@3044@3044@3044@3044@3044@3044@3044@3044@3044@3044@3046@3046@3046@3046@3046@3046@3046@3046@3046@3046@3048@3048@3048@3048@3048@3048@3048@3048@3048@3048@304a@304a@304a@304a@304a@304a@304a@304a@[e-mail]

「Mapping of Identifiers to File Names」で説明されているマッピングにより、平仮名は1文字あたり5バイトになります。これに拡張子4バイトが加わります。

255バイトがストレージエンジンにおけるファイル名の長さの上限だと思われます。

[追記] 今回確認したmacOSの環境では、ファイル名の長さの上限はOSレベルで255文字です。ほかのOSでも、ファイル名の長さの上限が255バイトまたは255文字とするものがほとんどです (なお、OSが扱える パス名 の長さは一般にこれよりも長いです)。そのため、255バイトがストレージエンジンにおけるファイル名の長さの事実上の上限となると考えられます。

Comments

[ryorgyo]

評価まで時間がかかり大変申し訳ございません。

ご回答いただきありがとうございます。

ストレージエンジンの255バイトが制限となっていたんですね。
windows、MacOSともに発生した現象でしたので、ストレージエンジン周りをもう少し調査してみようと思います。