json_each

説明

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

構文

json_each(json_object_expr)

パラメータ

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

戻り値

2つのカラムを返します。1つは key という名前で、もう1つは value という名前です。key カラムは VARCHAR 値を格納し、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 カラムを key と value の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     |
+------+------------------+------+-------+