utf8mb4
collation で文字セットを使用することをお勧めしますutf8mb4_unicode_ci
。
文字セット はutf8
、使用可能な文字の約 6% という少量の UTF-8 コード ポイントのみをサポートします。utf8
Basic Multilingual Plane (BMP) のみをサポートします。他に16機あります。各プレーンには 65,536 文字が含まれます。utf8mb4
17 面すべてをサポートします。
MySQL は 4 バイトの UTF-8 文字を切り捨て、データが破損します。
文字セットは、utf8mb4
2010 年 3 月 24 日に MySQL 5.5.3 で導入されました。
新しい文字セットを使用するために必要な変更のいくつかは簡単ではありません。
- アプリケーション データベース アダプタで変更が必要になる場合があります。
- 文字セット、照合順序の設定、innodb_file_format から Barracuda への切り替えなど、my.cnf に変更を加える必要があります。
- SQL CREATE ステートメントには、以下を含める必要がある場合があります。
ROW_FORMAT=DYNAMIC
- VARCHAR(192) 以上のインデックスには DYNAMIC が必要です。
注:Barracuda
からAntelope
に切り替えるには、MySQL サービスを複数回再起動する必要がある場合があります。innodb_file_format_max
は、MySQL サービスが再起動されるまで変更されません: innodb_file_format = barracuda
.
MySQL は古いAntelope
InnoDB ファイル形式を使用します。Barracuda
文字セットに切り替えた後、インデックスとキーを作成するための SQL エラーを発生させたくない場合に必要な、動的行フォーマットをサポートします。utf8mb4
- #1709 - インデックス列のサイズが大きすぎます。列の最大サイズは 767 バイトです。
- #1071 - 指定されたキーが長すぎます。キーの最大長は 767 バイトです
次のシナリオは、MySQL 5.6.17 でテストされています。デフォルトでは、MySQL は次のように構成されています。
SHOW VARIABLES;
innodb_large_prefix = OFF
innodb_file_format = Antelope
MySQL サービスを停止し、既存の my.cnf にオプションを追加します。
[client]
default-character-set= utf8mb4
[mysqld]
explicit_defaults_for_timestamp = true
innodb_large_prefix = true
innodb_file_format = barracuda
innodb_file_format_max = barracuda
innodb_file_per_table = true
# Character collation
character_set_server=utf8mb4
collation_server=utf8mb4_unicode_ci
SQL CREATE ステートメントの例:
CREATE TABLE Contacts (
id INT AUTO_INCREMENT NOT NULL,
ownerId INT DEFAULT NULL,
created timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
modified timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
contact VARCHAR(640) NOT NULL,
prefix VARCHAR(128) NOT NULL,
first VARCHAR(128) NOT NULL,
middle VARCHAR(128) NOT NULL,
last VARCHAR(128) NOT NULL,
suffix VARCHAR(128) NOT NULL,
notes MEDIUMTEXT NOT NULL,
INDEX IDX_CA367725E05EFD25 (ownerId),
INDEX created (created),
INDEX modified_idx (modified),
INDEX contact_idx (contact),
PRIMARY KEY(id)
) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci ENGINE = InnoDB ROW_FORMAT=DYNAMIC;
- がCREATE ステートメントから削除された
INDEX contact_idx (contact)
場合に生成されたエラー #1709 を確認できます。ROW_FORMAT=DYNAMIC
注: 最初の 128 文字に制限するようにインデックスを変更すると、contact
Barracuda を使用する必要がなくなります。ROW_FORMAT=DYNAMIC
INDEX contact_idx (contact(128)),
また、フィールドのサイズが であると表示されている場合、それVARCHAR(128)
は 128 バイトではありません。128 個の 4 バイト文字または 128 個の 1 バイト文字を使用できます。
このINSERT
ステートメントには、2 行目に 4 バイトの「poo」文字が含まれている必要があります。
INSERT INTO `Contacts` (`id`, `ownerId`, `created`, `modified`, `contact`, `prefix`, `first`, `middle`, `last`, `suffix`, `notes`) VALUES
(1, NULL, '0000-00-00 00:00:00', '2014-08-25 03:00:36', '1234567890', '12345678901234567890', '1234567890123456789012345678901234567890', '1234567890123456789012345678901234567890', '12345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678', '', ''),
(2, NULL, '0000-00-00 00:00:00', '2014-08-25 03:05:57', 'poo', '12345678901234567890', '', '', '', '', ''),
(3, NULL, '0000-00-00 00:00:00', '2014-08-25 03:05:57', 'poo', '12345678901234567890', '', '', '123', '', '');
last
列によって使用されるスペースの量を確認できます。
mysql> SELECT BIT_LENGTH(`last`), CHAR_LENGTH(`last`) FROM `Contacts`;
+--------------------+---------------------+
| BIT_LENGTH(`last`) | CHAR_LENGTH(`last`) |
+--------------------+---------------------+
| 1024 | 128 | -- All characters are ASCII
| 4096 | 128 | -- All characters are 4 bytes
| 4024 | 128 | -- 3 characters are ASCII, 125 are 4 bytes
+--------------------+---------------------+
データベース アダプタで、接続の文字セットと照合順序を設定することができます。
SET NAMES 'utf8mb4' COLLATE 'utf8mb4_unicode_ci'
PHP では、これは次のように設定されます。\PDO::MYSQL_ATTR_INIT_COMMAND
参考文献: