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

JSON_ARRAY

説明​

指定された要素を含むJSON配列を生成します。パラメータが渡されない場合は空の配列を返します。

構文​

JSON_ARRAY([<expression>, ...])

引数​

可変引数：​

  • <expression>: JSON配列に含める要素。単一の型または複数の型を指定でき、NULLも含みます。

戻り値​

Nullable(JSON): 指定された値を含むJSON配列を返します。値が指定されていない場合は、空のJSON配列が返されます。

パラメータ​

可変パラメータ：​

  • <expression>: JSON配列に含める要素。NULLを含む、異なる型の単一または複数の値を指定できます。

戻り値​

JSON: パラメータリストで構成されたJSON配列を返します。

使用上の注意​

  • JSON_ARRAYの実装では、TO_JSON関数を暗黙的に呼び出して異なる型のパラメータをJSON値に変換するため、パラメータはTO_JSONでサポートされている型である必要があります

  • NULLはJSON nullに変換されます。配列内でnull値を保持したくない場合は、JSON_ARRAY_IGNORE_NULL関数を使用できます。

  • パラメータの型がTO_JSONでサポートされていない場合、エラーが発生します。そのようなパラメータは、例えば最初にString型に変換できます：

    select JSON_ARRAY(CAST(NOW() as String));

NOW()関数はDateTime型を返すため、CAST関数を使用してString型に変換する必要があります

  • パラメータがJSON文字列で、JSONオブジェクトとして配列に追加したい場合は、JSON_PARSE関数を明示的に呼び出してJSONオブジェクトとして解析する必要があります：

    select JSON_ARRAY(JSON_PARSE('{"key": "value"}'));

例​

  1. 通常のパラメータ

    select json_array() as empty_array, json_array(1) v1, json_array(1, 'abc') v2;
    +-------------+------+-----------+
    | empty_array | v1   | v2        |
    +-------------+------+-----------+
    | []          | [1]  | [1,"abc"] |
    +-------------+------+-----------+

  2. NULLパラメータ

    select json_array(null) v1, json_array(1, null, 'I am a string') v2;
    +--------+--------------------------+
    | v1     | v2                       |
    +--------+--------------------------+
    | [null] | [1,null,"I am a string"] |
    +--------+--------------------------+

  3. サポートされていないパラメータタイプ

    select json_array('item1', map(123, 'abc'));
    ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: to_json(MAP<TINYINT,VARCHAR(3)>)

  4. Mapタイプパラメータは明示的にJSONに変換することができます

    select json_array(1, cast(map('key', 'value') as json));
    +--------------------------------------------------+
    | json_array(1, cast(map('key', 'value') as json)) |
    +--------------------------------------------------+
    | [1,{"key":"value"}]                              |
    +--------------------------------------------------+

  5. JSON文字列は文字列の形式で配列に追加されます

    select json_array('{"key1": "value", "key2": [1, "I am a string", 3]}');
    +------------------------------------------------------------------+
    | json_array('{"key1": "value", "key2": [1, "I am a string", 3]}') |
    +------------------------------------------------------------------+
    | ["{\"key1\": \"value\", \"key2\": [1, \"I am a string\", 3]}"]   |
    +------------------------------------------------------------------+

  6. JSON文字列はjson_parseを使用して解析し、その後json_arrayに渡すことができます

    select json_array(json_parse('{"key1": "value", "key2": [1, "I am a string", 3]}'));
    +------------------------------------------------------------------------------+
    | json_array(json_parse('{"key1": "value", "key2": [1, "I am a string", 3]}')) |
    +------------------------------------------------------------------------------+
    | [{"key1":"value","key2":[1,"I am a string",3]}]                              |
    +------------------------------------------------------------------------------+