

MySQLではバージョン5.7よりJSONデータを取り扱うための「JSON」というデータ型が登場しました。
本記事では、MySQL環境におけるJSONデータの取り扱い方法に関してサンプルSQLを交えながらご紹介していきたいと思います。
MySQL5.7から利用可能となったJSON型のテーブルを作成してみよう
MySQLでJSON型を使う場合、型の指定に「JSON」と入力するだけで利用が可能です。
MySQL環境としてバージョン5.7以上であることが条件となりますので、まずはインストールされているMySQLのバージョンを下記コマンドで確認しておきましょう。
1 |
mysql --version |
JSON型を含めたテーブルを作成してみよう
では実際に「CREATE TABLE」コマンドでJSON型を含んだテーブルを作成してみましょう。
1 |
create table sample_json(id int, json_data json); |
「JSON」と型指定するだけでJSON型が取り扱えるカラムが作成されます。
JSONデータをINSERTしてみよう
作成したテーブルにJSONデータをINSERTしてみましょう。
サンプルSQLは下記の通りとなります。
1 2 |
insert into sample_json values(1, '{"name" : "ポテパン1", "occupation" : "プログラマー"}'); insert into sample_json values(2, '{"name" : "ポテパン2", "occupation" : "デザイナー"}'); |
JSON形式({“key : value”, …})でデータを指定することでINSERT処理が実行可能です。
MySQL環境でテーブルに登録されたJSON型を操作してみよう
JSON型を持つテーブルの作成とデータのINSERTが完了しましたので、実際にテーブル操作の基本となる「SELECT」「UPDATE」「DELETE」の使い方についてご紹介していきます。
JSON型を使用したテーブルでSELECTコマンドを実行してみよう
テーブル操作の基本となる「SELECT」コマンドから実行してみたいと思います。
1 |
select * from sample_json; |
サンプルSQLを実行した結果が下記の通りとなります。
1 2 3 4 5 6 |
+------+---------------------------------------------------------------+ | id | json_data | +------+---------------------------------------------------------------+ | 1 | {"name": "ポテパン1", "occupation": "プログラマー"} | | 2 | {"name": "ポテパン2", "occupation": "デザイナー"} | +------+---------------------------------------------------------------+ |
上述したINSERT文で設定した内容がテーブルに格納されていることをご確認いただけます。
JSON型で定義されたカラムの値をUPDATEしてみよう
次にテーブルに登録済みのJSON型のカラム値を「UPDATE」コマンドで更新してみたいと思います。
1 |
update sample_json set json_data ='{"name" :"ポテパン1", "occupation" : "営業" }' where json_data->"$.name" = "ポテパン1"; |
今回のサンプルではJSON型である「json_data」カラムのkey「name」のvalue値が「ポテパン1」のデータを更新しています。
WHERE句に「カラム名->$.key = value」と指定することで、UPDATEしたい特定のデータのみを更新することが可能です。
サンプルSQLを実行した結果が下記となります。
1 2 3 4 5 6 |
+------+------------------------------------------------------------+ | id | json_data | +------+------------------------------------------------------------+ | 1 | {"name": "ポテパン1", "occupation": "営業"} | | 2 | {"name": "ポテパン2", "occupation": "デザイナー"} | +------+------------------------------------------------------------+ |
JSON_SET関数を利用することでJSONの指定した部分のみを更新することが可能
上述したUPDATE文では、SETするJSONデータを変更しない箇所も含めて全て記述する必要がありました。
一方でJSON_SET関数を利用することで、指定した部分のデータのみを更新することも可能です。
「id=1」の名前を「ポテパン1」から「ポテパン1変更」にUPDATEするサンプルSQLです。
1 |
update sample_json set json_data = json_set(json_data, "$.name", "ポテパ ン1変更") where id = 1; |
実行した結果が下記の通りとなります。
1 2 3 4 5 6 |
+------+------------------------------------------------------------+ | id | json_data | +------+------------------------------------------------------------+ | 1 | {"name": "ポテパン1変更", "occupation": "営業"} | | 2 | {"name": "ポテパン2", "occupation": "デザイナー"} | +------+------------------------------------------------------------+ |

JSONデータの記述量が多い場合など、JSON_SET関数を利用することでSQL文が読みやすくなることもあるため、状況によって使い分けてみてください。
JSON型のカラム値を指定してデータを削除してみよう
JSON型のカラム値を指定してデータ削除を行ってみましょう。
WHERE句に上述した「カラム名->$.key = value」を指定してデータ削除を行うことも可能ですが、今回は「JSON_EXTRACT」という関数を利用して対象データを指定してみたいと思います。
1 |
delete from sample_json where json_extract(json_data, "$.name") = "ポテパン1"; |
実行した結果が下記の通りとなります。
1 2 3 4 5 |
+------+------------------------------------------------------------+ | id | json_data | +------+------------------------------------------------------------+ | 2 | {"name": "ポテパン2", "occupation": "デザイナー"} | +------+------------------------------------------------------------+ |
指定したJSONの行データが削除されていることがご確認いただけます。
JSON_EXTRACTの使い方は「json_extract(カラム名, “$.key名”)」となります。
JSON_EXTRACTを指定することで、「key」に対する「value」が抽出出来るため、where句の場合には「=」演算子を利用して比較を行っています。
さいごに:MySQLでのJSON型は頻繁には使われない
本記事では、MySQL5.7より利用が可能となっているJSON型の使い方について、サンプルSQLを交えながらご紹介してきました。
JSON型は、MySQLを含むリレーショナルデータベースの基本的な考え方からするとイレギュラーな型定義と言えます。
リレーショナルデータベースのテーブル設計時にJSON型を積極的に使うものではありませんが、実務上JSON型が必要となるケースも考えられるため、使い方については最低限しっかりと理解しておきましょう。
#php get_template_part('include/articles/services-provided') ?>
関連記事

「カラム名->$.key = value」の記述法はUPDATEに限らず、SELECTやDELETEでも使えます。