Ubuntu(WSL)のMariaDBでJSONを使う

WSL（Ubuntu18.04）のMariaDBでJSONを保存したいと思ったが、Ubuntu18.04のaptコマンドでインストールされるMariaDBのバージョンは10.1で、JSONデータ型が使用できるのは10.2以降（JSON Data Type）。そこで現時点の最新安定版10.4をインストールしてJSONを登録できるようにする。

環境

WSL(Ubuntu18.04)。
$ lsb_release -dr Description: Ubuntu 18.04.3 LTS Release: 18.04

リポジトリのセットアップ

MariaDBのサイト（MariaDB Package Repository Setup and Usage）に、新しいバージョンのMariaDB用リポジトリをセットアップするスクリプトが用意されている。それをダウンロードして、MariaDB Serverのバージョン10.4を指定して実行する。
$ curl -LsS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash -s -- --mariadb-server-version="mariadb-10.4"

作成されたリポジトリ設定ファイルを確認。MariaDB Serverの設定でバージョンが10.4になっている。
$ cat /etc/apt/sources.list.d/mariadb.list # MariaDB Server # To use a different major version of the server, or to pin to a specific minor version, change URI below. deb http://downloads.mariadb.com/MariaDB/mariadb-10.4/repo/ubuntu bionic main ...

aptコマンドで確認するとインストールされるバージョンが10.4になっている。
$ apt search mariadb-server mariadb-server/不明 1:10.4.12+maria~bionic all [1:10.1.44-0ubuntu0.18.04.1 から アップグレード可] MariaDB database server (metapackage depending on the latest version) ...

MariaDB10.4のインストール

リポジトリのセットアップができたら、aptコマンドで通常通りにインストールできる。
$ sudo apt install mariadb-server mariadb-client

インストールされたMariaDB Clientのバージョンを確認。
$ mysql -V mysql Ver 15.1 Distrib 10.4.12-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2

MariaDB Serverもバージョン10.4がインストールされた。
$ sudo mysqladmin version mysqladmin Ver 9.1 Distrib 10.4.12-MariaDB, for debian-linux-gnu on x86_64 Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. ...

MariaDBでJSONデータ型を使う

JSON Data Typeによると、バージョン10.2.7で追加されたデータ型であるJSONはLONGTEXTのエイリアス。JSON以外のテキストが登録されるのを防ぐためにJSON_VALIDという関数が用意されており、CHECK制約として使える。ただし、10.4.3以上ではJSONデータ型を使うときにはこの制約が自動で適用されるらしい。

今回インストールしたバージョンは10.4.12だが、CHECK制約をつけて試してみる。まずはMariaDBに接続してテーブルを作成。JSONデータ型のdataカラムはLONGTEXTになっている。
> CREATE TABLE json_test ( data JSON CHECK (JSON_VALID(data)) ); > desc json_test; +-------+----------+------+-----+---------+-------+ | Field | Type | Null | Key | Default | Extra | +-------+----------+------+-----+---------+-------+ | data | longtext | YES | | NULL | | +-------+----------+------+-----+---------+-------+

JSONでなくただのテキストをINSERTしようとするとエラーになる。
> INSERT INTO json_test VALUES ('json'); ERROR 4025 (23000): CONSTRAINT `json_test.data` failed for `test`.`json_test`

JSONをINSERTしてみる。
> INSERT INTO json_test VALUES ('{"id": 100, "name": "test", "color": "blue"}'); > select * from json_test; +----------------------------------------------+ | data | +----------------------------------------------+ | {"id": 100, "name": "test", "color": "blue"} | +----------------------------------------------+

JSONデータ型の使い方についてはJSON を扱う – MariaDB Serverが参考になる。