json_each

説明

JSON オブジェクトの最外層の要素をキーと値のペアに展開し、各要素に対して1行のテーブルを返します。

構文

json_each(json_object_expr)

パラメータ

json_object_expr: JSON オブジェクトを表す式です。オブジェクトは JSON カラム、または PARSE_JSON などの JSON コンストラクタ関数によって生成された JSON オブジェクトであることができます。

戻り値

2つのカラムを返します。1つは key という名前のカラムで VARCHAR 値を格納し、もう1つは value という名前のカラムで JSON 値を格納します。

使用上の注意

json_each 関数はテーブル関数であり、テーブルを返します。返されるテーブルは複数の行からなる結果セットです。したがって、元のテーブルに返されたテーブルをジョインするためには、FROM 句で lateral join を使用する必要があります。lateral join は必須ですが、LATERAL キーワードはオプションです。json_each 関数は SELECT 句で使用することはできません。

例

-- tj という名前のテーブルを例として使用します。tj テーブルでは、j カラムが JSON オブジェクトです。
mysql> SELECT * FROM tj;
+------+------------------+
| id   | j                |
+------+------------------+
|    1 | {"a": 1, "b": 2} |
|    3 | {"a": 3}         |
+------+------------------+

-- tj テーブルの j カラムをキーと値で2つのカラムに展開し、複数の行からなる結果セットを取得します。この例では、LATERAL キーワードを使用して結果セットを tj テーブルにジョインしています。

mysql> SELECT * FROM tj, LATERAL json_each(j);
+------+------------------+------+-------+
| id   | j                | key  | value |
+------+------------------+------+-------+
|    1 | {"a": 1, "b": 2} | a    | 1     |
|    1 | {"a": 1, "b": 2} | b    | 2     |
|    3 | {"a": 3}         | a    | 3     |
+------+------------------+------+-------+