MySQL の文字セットと照合順序

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →

MySQL の文字セットは、文字列がどのように格納されるか（どのバイトがどの文字を表すか）を制御します。照合順序は、文字列がどのように比較され、ソートされるかを制御します。最初にこれらを正しく設定しておけば、後から修正するのが大変なデータの破損や誤ったソートを避けられます。

utf8mb4 — 正しいデフォルト

常に utf8mb4 を使ってください。MySQL の utf8（mb4 なし）は 3 バイトのエンコーディングで、4 バイトの Unicode 文字を格納できません。これには絵文字、多くの漢字、および各種の記号が含まれます。utf8mb4 は完全な UTF-8 エンコーディングです。

-- Verify your database is using utf8mb4
SHOW CREATE DATABASE myapp;
-- Should show: DEFAULT CHARACTER SET utf8mb4

utf8 を使っているレガシーなデータベースの場合、utf8mb4 への移行には、データベース、テーブル、および列の変換が必要です。

文字セットのクイックリファレンス

文字セット	使う場面	避ける場面	誤った場合の移行コスト
`utf8mb4`	すべての新しいスキーマ — 絵文字と現代の CJK を含むすべての Unicode を扱える	新しい作業では決して避けない	該当なし — これが正しいデフォルト
`utf8`（レガシーの 3 バイト）	決して使わない — 残す唯一の理由は移行ウィンドウを確保できない場合のみ	絵文字、補助 CJK 文字、またはあらゆる 4 バイト Unicode の格納	中 — `ALTER TABLE … CONVERT TO CHARACTER SET utf8mb4`。影響を受けるすべてのテーブルを再構築する
`latin1`	レガシーなスキーマ内の 1 バイトの西ヨーロッパ言語テキスト。ASCII のみのデータでは `utf8mb4` よりわずかに小さいストレージ	ユーザー生成コンテンツ、多言語データ、または Web に関わるすべてのもの	高 — バイナリセーフな変換は自動では行われない。latin1 の範囲外のデータは静かに破損する
`binary` / `BLOB`	生のバイト — ファイルの内容、暗号学的ハッシュ、パックされたバイナリ形式	検索、ソート、または表示するテキスト	低 — `BINARY` 列には文字セットのセマンティクスがない。テキストの文字セットへの変換にはアプリケーションレベルのデコードが必要

コストの列は、誤った選択を後から修正するのに必要な作業についてであり、文字セット自体のパフォーマンスコストではありません。latin1 は罠です。どんなバイト値もエラーなく受け入れるため、不正なデータが静かに入り込み、表示または変換しようとしたときに初めて表面化します。

照合順序

照合順序は、ソート順と比較の動作を決定します。一般的な選択肢は次のとおりです。

照合順序	ソートの動作	大文字小文字を区別	アクセントを区別
`utf8mb4_general_ci`	近似的な Unicode 順	いいえ	いいえ
`utf8mb4_unicode_ci`	完全な Unicode アルゴリズム	いいえ	いいえ
`utf8mb4_0900_ai_ci`	Unicode 9.0、最も正確	いいえ	いいえ
`utf8mb4_bin`	バイナリ（バイト単位）	はい	はい
`utf8mb4_0900_as_cs`	Unicode 9.0	はい	はい

utf8mb4_0900_ai_ci はデフォルトの照合順序であり、汎用的には最良の選択です。Unicode を正しく扱い、大文字小文字を区別せず（ci）、アクセントも区別しません（ai）。utf8mb4_bin は、バイト単位の正確な一致が必要な場合にだけ使ってください。 ci = 大文字小文字を区別しない、cs = 大文字小文字を区別する、ai = アクセントを区別しない、as = アクセントを区別する。

文字セットの設定

データベース作成時:

CREATE DATABASE myapp
    CHARACTER SET utf8mb4
    COLLATE utf8mb4_0900_ai_ci;

テーブル作成時:

CREATE TABLE users (
    id   INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100)
) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

列レベル（テーブルのデフォルトを上書き）:

CREATE TABLE products (
    id          INT AUTO_INCREMENT PRIMARY KEY,
    name        VARCHAR(100),
    description TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_bin
);

列レベルの文字セットは、テーブルの他の列が大文字小文字を区別しない一方で、1 つの列だけ大文字小文字を区別する一致が必要な場合に役立ちます。 列の文字セットを変更する:

ALTER TABLE users
MODIFY name VARCHAR(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

テーブル全体を変換する:

ALTER TABLE users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

CONVERT TO は 1 つのステートメントですべての列を変更します。テーブルを再構築するため、テーブルのサイズに比例した時間がかかります。

文字セットの確認

-- Database level
SHOW CREATE DATABASE myapp;

-- Table and column level
SHOW CREATE TABLE users;

-- Connection level
SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';

SHOW CREATE TABLE の出力で文字セットが表示されない列は、テーブルのデフォルトを継承しています。

接続の文字セット

接続の文字セットは、MySQL がクライアントから期待し、文字列リテラルに使うエンコーディングを制御します。常に明示的に設定してください。

SET NAMES utf8mb4;
-- equivalent to:
SET character_set_client = utf8mb4;
SET character_set_results = utf8mb4;
SET character_set_connection = utf8mb4;

ほとんどのドライバーは、接続文字列で文字セットを設定すると、これを自動的に行います。接続のデフォルトは utf8mb4 であるため、明示的な上書きが必要になることはまれです。

照合順序がクエリに与える影響

照合順序は WHERE、ORDER BY、および一意性に影響します。

-- utf8mb4_0900_ai_ci: these three are equal
SELECT * FROM users WHERE name = 'alice';  -- matches Alice, ALICE, alice

-- utf8mb4_bin: exact match only
SELECT * FROM users WHERE name COLLATE utf8mb4_bin = 'alice';  -- only 'alice'

列のデフォルトとは異なる照合順序でソートするには、次のようにします。

SELECT name FROM users ORDER BY name COLLATE utf8mb4_unicode_ci;

utf8 から utf8mb4 への変換

レガシーなデータベースが utf8（3 バイト）を使っている場合は、変換します。

-- Convert one table
ALTER TABLE users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

-- Update the database default
ALTER DATABASE myapp CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

新しい接続のデフォルトを utf8mb4 にするため、サーバーの構成も更新します。

[mysqld]
character_set_server = utf8mb4
collation_server = utf8mb4_0900_ai_ci

[client]
default-character-set = utf8mb4

大きなテーブルの変換には時間がかかり、テーブルが再構築されます。メンテナンスウィンドウ中にスケジュールするか、オンラインスキーマ変更ツールを使ってください。

よくある質問

MySQL の `utf8` が絵文字をサポートしないのはなぜですか?

MySQL の utf8 は、4 バイトの Unicode 拡張より前に作られた、非標準の 3 バイトの UTF-8 サブセットです。絵文字（および他の多くの現代の Unicode 文字）には 4 バイトが必要です。utf8mb4 が UTF-8 の正しい完全な実装です。古い utf8 エイリアスは下位互換性のためだけに存在します。新しいスキーマでは決して使わないでください。

照合順序の変更は既存のデータに影響しますか?

照合順序を変更しても、格納されたバイトは変わりません。変わるのは、それらのバイトがどのように比較され、ソートされるかです。ただし、ユニークインデックスは照合順序を使って強制されるため、_bin から _ci に変更すると、先に解決しなければならない衝突（Alice と alice が等しくなる）が明らかになることがあります。

どの照合順序を使うべきですか?

ほとんどの用途では utf8mb4_0900_ai_ci です。デフォルトの照合順序であり、Unicode をうまく扱います。utf8mb4_bin は、バイト単位の正確な一致が必要な場合にだけ使ってください。新しいプロジェクトでは utf8mb4_general_ci を避けてください。_0900_ai_ci より古く、一部の Unicode のエッジケースを正しく扱えません。

トラブルシューティング

問題	解決策
絵文字が `????` として格納される	列または接続が `utf8`（3 バイト）を使っています。`utf8mb4` に変換します
`Incorrect string value` エラー	列の文字セットでエンコードできない文字を挿入しています。列を `utf8mb4` に変換します
ソート順が正しくない	照合順序の不一致です。`SHOW CREATE TABLE` を確認し、`ORDER BY` に明示的な `COLLATE` を設定します
大文字小文字を区別する比較が機能しない	列が `_ci` の照合順序を使っています。WHERE 句で `COLLATE utf8mb4_bin` を使うか、列の照合順序を変更します
`Illegal mix of collations` エラー	異なる照合順序を持つ列またはリテラルを比較しています。`COLLATE` を追加して一致させるか、列を変換します

MySQL Tutorial

ガイド

データの保存

クエリの作成

データの保護

パフォーマンスの最適化

AI で構築する

MySQL の運用

アプリケーションの接続

拡張機能の作成

VillageSQL is a drop-in replacement for MySQL with extensions.

utf8mb4 — 正しいデフォルト

文字セットのクイックリファレンス

照合順序

文字セットの設定

文字セットの確認

接続の文字セット

照合順序がクエリに与える影響

utf8 から utf8mb4 への変換

よくある質問

MySQL の `utf8` が絵文字をサポートしないのはなぜですか?

照合順序の変更は既存のデータに影響しますか?

どの照合順序を使うべきですか?

トラブルシューティング

関連項目

VillageSQL is a drop-in replacement for MySQL with extensions.

utf8mb4 — 正しいデフォルト

文字セットのクイックリファレンス

照合順序

文字セットの設定

文字セットの確認

接続の文字セット

照合順序がクエリに与える影響

utf8 から utf8mb4 への変換

よくある質問

MySQL の utf8 が絵文字をサポートしないのはなぜですか?

照合順序の変更は既存のデータに影響しますか?

どの照合順序を使うべきですか?

トラブルシューティング

関連項目

MySQL の `utf8` が絵文字をサポートしないのはなぜですか?