メインコンテンツまでスキップ
バージョン: 3.1

json_object

説明

1つ以上のキーと値のペアを、キーと値のペアからなるJSONオブジェクトに変換します。キーと値のペアは、辞書順でキーによってソートされます。

構文

json_object(key, value, ...)

パラメータ

  • key: JSONオブジェクト内のキー。VARCHARデータ型のみサポートされます。

  • value: JSONオブジェクト内の値。NULL値および以下のデータ型のみサポートされます: STRING, VARCHAR, CHAR, JSON, TINYINT, SMALLINT, INT, BIGINT, LARGEINT, DOUBLE, FLOAT, BOOLEAN。

戻り値

JSONオブジェクトを返します。

キーと値の合計数が奇数の場合、JSON_OBJECT関数は最後のフィールドにNULLを埋めます。

例1: 異なるデータ型の値からなるJSONオブジェクトを構築します。

mysql> SELECT json_object('name', 'starrocks', 'active', true, 'published', 2020);

-> {"active": true, "name": "starrocks", "published": 2020}

例2: 入れ子になったJSON_OBJECT関数を使用してJSONオブジェクトを構築します。

mysql> SELECT json_object('k1', 1, 'k2', json_object('k2', 2), 'k3', json_array(4, 5));

-> {"k1": 1, "k2": {"k2": 2}, "k3": [4, 5]}

例3: 空のJSONオブジェクトを構築します。

mysql> SELECT json_object();

-> {}