「mysql5.7」の記事 - Crieit

Docker から MySQL 用のコンテナで初期化・起動しようとしたら The server option 'lower_case_table_names' is configured ... エラーで失敗する

2021-11-20T17:13:30+09:00

現象

Docker から自作の MySQL 用のコンテナで初期化・起動しようとしたら MySQL が起動しておらず、手動で初期化コマンドを実行したら以下のエラーで失敗する現象に遭遇しました。

[ERROR] The server option 'lower_case_table_names' is configured to use case sensitive table names but the data directory is on a case-insensitive file system which is an unsupported combination. Please consider either

using a case sensitive file system for your data directory or switching to a case-insensitive table name mode.

環境

環境としては以下の自作の LAMP環境作成用の Docker Compose を使用しました。

GitHub - arm-band/docker_compose_ambergrease

MySQL5.7系で、 entrypoint で

設定ファイルをテンプレートからコピーして配置
/usr/sbin/mysqld --user=mysql --initialize & で初期化コマンド実行
/usr/sbin/mysqld --user=mysql & で MySQL 起動
MySQL のログから初期パスワードを見つけ出し、環境変数で設定された値に管理者パスワードを変更

をしています。

このうち、2つ目の /usr/sbin/mysqld --user=mysql --initialize & で上述のエラーが発生していました。

対処

エラー文は「 MySQL の設定では大文字小文字を区別する設定になっているが、 dataディレクトリのファイルシステムは大文字小文字を区別しない環境になっていて不一致を起こしているので、どちらかに統一してね」ということのようです。

今回は Docker for Windows 利用で、 dataディレクトリはホスト側の Windows のフォルダにボリュームをマウントしています。また、データはコンテナを落としても保持していてほしいので Windows とのボリュームマウントを解除する方向性はなし。

そのため、ファイルシステムは Windows 依存になるので、大文字小文字を区別するファイルシステムに寄せるのは厳しい。したがって、 MySQL 側の設定を調整することにします。

[mysqld]

## 略

# not only lowercase characters in tablename
# lower_case_table_names = 0
lower_case_table_names = 1

該当の設定は lower_case_table_names 。この値0だと大文字小文字を区別する、1だと小文字に変換、2だと大文字小文字を区別してディスクに保存するが MySQL からのルックアップ時に小文字に変換、という挙動になるようです。

今回はシンプルに全て小文字変換で1とすることにしました。

これで問題が解決されたことを確認。

参考

【MySQL】ALTER TABLEする際の空き容量の確認方法

2021-01-13T15:54:43+09:00

はじめに

Zabbix3.0から4.0へのバージョンアップの際、DB(MySQL)のテーブルをALTER TABLEする必要があります。
テーブル同程度のディスク空き容量が必要とのことだが、具体的にどうやって算出すれば良いのか分からなかったため、調べました。

まとめ

ALTER TABLEの際は元のテーブルと同程度のディスク空き容量が必要
テーブルのコピーは元テーブルと同じディレクトリに作成されるため、元テーブルの格納ディレクトリがマウントされているディスクの空き容量を確認する

検証環境

MySQL:5.7.32

調べたこと

まず、以下の記事にもある通り、ALTER TABLEコマンドを実行すると、対象テーブルのコピーを作成するため、元テーブルのサイズと同程度のディスク空き容量が必要となる。

「[ALTER TABLEを上手に使いこなそう。」漢のコンピュータ道,2009-05-11(参照:2021-01-12)]

ALTER TABLEでは完全なテーブルのコピーを作成する必要があるので、元のテーブルのサイズと同じぐらいのディスク空き容量が必要であることにも注意しなければいけない。

また、元テーブルのコピーは、元テーブルと同じディレクトリに作成される。

「巨大なサイズのテーブルに対するALTER TABLE実行時間の概算方法」PAYFORWARD,2016-04-07(参照:2021-01-12)

50GBのテーブルを対象としているときは50GB以上の空き領域が必要。ディスク上に一時テーブルの格納場所だが、ほとんどの場合、元のテーブルと同じディレクトリにsql_XXXXというファイル名で生成する。

つまり、元テーブルの格納ディレクトリがマウントされているディスクの空き容量を確認する必要がある。

テーブルの格納ディレクトリの確認

MySQLにログインし、以下コマンドを実行する。

YumaInaura「MySQL | データディレクトリの場所を確認する ( select @@datadir )」Qiita,2017-05-16(参照:2021-01-13)

mysql> select @@datadir;
+-----------------+
| @@datadir       |
+-----------------+
| /var/lib/mysql/ |
+-----------------+
1 row in set (0.00 sec)

ディスクの空き容量確認

「dfコマンドについてまとめました【Linuxコマンド集】」エンジニアの入り口,リナックスアカデミー,2016-10-04(参照:2021-01-13)

以下のコマンドを実施する。

# df -h /var/lib/mysql
Filesystem Size  Used Avail Use% Mounted on
/dev/sda1  5.1G  2.4G  2.5G  49% /

テーブルの使用量確認

ikenji「MySQLでDBとテーブルのサイズを確認するSQL」Qiita,2019-12-13(参照:2021-01-13)

MySQLにログインし、以下のコマンドを実行する。

>  SELECT  
    table_name, engine, table_rows AS tbl_rows,
    avg_row_length AS rlen,  
    (data_length+index_length)/1024/1024 AS all_mb,
    (data_length)/1024/1024 AS data_mb,
    (index_length)/1024/1024 AS index_mb
FROM 
    information_schema.tables  
WHERE
    table_schema='{$DATABASE}' 
ORDER BY
    (data_length+index_length) DESC;
+----------------------------+--------+----------+-------+-------------+------------+------------+
| table_name                 | engine | tbl_rows | rlen  | all_mb      | data_mb    | index_mb   |
+----------------------------+--------+----------+-------+-------------+------------+------------+
| history_uint               | InnoDB |    48725 |   107 | 10.03125000 | 5.01562500 | 5.01562500 |
(省略)
| housekeeper                | InnoDB |        0 |     0 |  0.01562500 | 0.01562500 | 0.00000000 |
+----------------------------+--------+----------+-------+-------------+------------+------------+
113 rows in set (0.03 sec)

ディスク空き容量は足りるか？

例えば、history_uintをALTER TABLEすると考える。

ディスク空き容量 : 2.5GB
テーブル使用量 : 10.03125000MB=0.009796142578GB≒0.001GB

余裕で足りそうです。
実際、Zabbix 3.0からZabbix 4.0にアップデートする場合は、ALTER TABLEが必要なテーブル分、計算する必要があります。

参考資料

「[ALTER TABLEを上手に使いこなそう。」漢のコンピュータ道,2009-05-11(参照:2021-01-12)]

「巨大なサイズのテーブルに対するALTER TABLE実行時間の概算方法」PAYFORWARD,2016-04-07(参照:2021-01-12)

YumaInaura「MySQL | データディレクトリの場所を確認する ( select @@datadir )」Qiita,2017-05-16(参照:2021-01-13)

「dfコマンドについてまとめました【Linuxコマンド集】」エンジニアの入り口,リナックスアカデミー,2016-10-04(参照:2021-01-13)

ikenji「MySQLでDBとテーブルのサイズを確認するSQL」Qiita,2019-12-13(参照:2021-01-13)