MySQL/MariaDB に Error 1709: Index column size too large. The maximum column size is 767 bytes. と言われた時は

MySQL や MariaDB で文字コードを utf8mb4 にしようとすると以下のようなエラーに遭遇することがあります。

Error 1709: Index column size too large. The maximum column size is 767 bytes.

例えばこんな感じでデータベースを作ったときですね。

これは InnoDB の最大キー長が 767 バイトに制限されているため。
この制限はある条件をクリアすると 3072 バイトまでに緩和^*1することができます。

その条件は row_format が DYNAMIC もしくは COMPRESSED （これを設定するためには innodb_file_format が Barracuda であることが必要になります）であり、innodb_file_per_table、innodb_large_prefix が有効になっていること。具体的には my.cnf に以下のような設定を記述するだけです。ちなみに以下の設定は既に作成済みのテーブルには効果がないので、設定変更後にテーブルを作り直す必要があることに注意が必要です。

/etc/my.cnf.d/server.cnf

最後の行の設定ができない場合には、テーブルの CREATE 文に以下のような感じで ROW_FORMAT=DYNAMIC を追加してやる必要があります。

• ^*1: 第32回　InnoDBインデックスの最大キー長について：MySQL道普請便り｜gihyo.jp … 技術評論社