MySQLではバージョン5.7よりJSONデータを取り扱うための「JSON」というデータ型が登場しました。
本記事では、MySQL環境におけるJSONデータの取り扱い方法に関してサンプルSQLを交えながらご紹介していきたいと思います。
目次
MySQL5.7から利用可能となったJSON型のテーブルを作成してみよう
MySQLでJSON型を使う場合、型の指定に「JSON」と入力するだけで利用が可能です。
MySQL環境としてバージョン5.7以上であることが条件となりますので、まずはインストールされているMySQLのバージョンを下記コマンドで確認しておきましょう。
mysql --version
JSON型を含めたテーブルを作成してみよう
では実際に「CREATE TABLE」コマンドでJSON型を含んだテーブルを作成してみましょう。
create table sample_json(id int, json_data json);
「JSON」と型指定するだけでJSON型が取り扱えるカラムが作成されます。
JSONデータをINSERTしてみよう
作成したテーブルにJSONデータをINSERTしてみましょう。
サンプルSQLは下記の通りとなります。
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」コマンドから実行してみたいと思います。
select * from sample_json;
サンプルSQLを実行した結果が下記の通りとなります。
+------+---------------------------------------------------------------+
| id | json_data |
+------+---------------------------------------------------------------+
| 1 | {"name": "ポテパン1", "occupation": "プログラマー"} |
| 2 | {"name": "ポテパン2", "occupation": "デザイナー"} |
+------+---------------------------------------------------------------+
上述したINSERT文で設定した内容がテーブルに格納されていることをご確認いただけます。
JSON型で定義されたカラムの値をUPDATEしてみよう
次にテーブルに登録済みのJSON型のカラム値を「UPDATE」コマンドで更新してみたいと思います。
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を実行した結果が下記となります。
+------+------------------------------------------------------------+
| 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です。
update sample_json set json_data = json_set(json_data, "$.name", "ポテパ ン1変更") where id = 1;
実行した結果が下記の通りとなります。
+------+------------------------------------------------------------+
| id | json_data |
+------+------------------------------------------------------------+
| 1 | {"name": "ポテパン1変更", "occupation": "営業"} |
| 2 | {"name": "ポテパン2", "occupation": "デザイナー"} |
+------+------------------------------------------------------------+
JSONデータの記述量が多い場合など、JSON_SET関数を利用することでSQL文が読みやすくなることもあるため、状況によって使い分けてみてください。
JSON型のカラム値を指定してデータを削除してみよう
JSON型のカラム値を指定してデータ削除を行ってみましょう。
WHERE句に上述した「カラム名->$.key = value」を指定してデータ削除を行うことも可能ですが、今回は「JSON_EXTRACT」という関数を利用して対象データを指定してみたいと思います。
delete from sample_json where json_extract(json_data, "$.name") = "ポテパン1";
実行した結果が下記の通りとなります。
+------+------------------------------------------------------------+
| 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型が必要となるケースも考えられるため、使い方については最低限しっかりと理解しておきましょう。
「カラム名->$.key = value」の記述法はUPDATEに限らず、SELECTやDELETEでも使えます。