본문으로 건너뛰기
최종 수정: 에

JSON_ARRAY_IGNORE_NULL

설명​

지정된 요소를 포함하는 JSON 배열을 생성합니다. 매개변수를 전달하지 않으면 빈 배열을 반환합니다.

구문​

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

매개변수​

가변 매개변수:​

  • <expression>: JSON 배열에 포함할 요소입니다. NULL을 포함하여 다양한 타입의 값을 하나 또는 여러 개 지정할 수 있습니다.

반환 값​

JSON: 매개변수 목록으로 구성된 JSON 배열을 반환합니다.

사용 시 참고 사항​

  • JSON_ARRAY_IGNORE_NULL은 내부적으로 TO_JSON 함수를 암시적으로 호출하여 다양한 타입의 매개변수를 JSON 값으로 변환하므로, 매개변수는 TO_JSON에서 지원하는 타입이어야 합니다.
  • NULL은 무시됩니다. 배열에 null 값을 유지하려면 JSON_ARRAY 함수를 사용할 수 있습니다.
  • 매개변수 타입이 TO_JSON에서 지원되지 않으면 오류가 발생합니다. 다음과 같이 먼저 해당 매개변수를 String 타입으로 변환할 수 있습니다. 
    select JSON_ARRAY_IGNORE_NULL(CAST(NOW() as String));

    NOW() 함수는 DateTime 타입을 반환하므로 CAST 함수를 사용하여 String 타입으로 변환해야 합니다.

  • 매개변수가 JSON 문자열이고 이를 JSON 객체로 배열에 추가하려면, JSON_PARSE 함수를 명시적으로 호출하여 JSON 객체로 파싱해야 합니다. 
    select JSON_ARRAY_IGNORE_NULL(JSON_PARSE('{"key": "value"}'));

예제​

  1. 일반적인 매개변수

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

  2. NULL 매개변수

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

  3. 지원되지 않는 매개변수 타입

    select json_array_ignore_null('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_ignore_null(1, cast(map('key', 'value') as json));
    +--------------------------------------------------------------+
    | json_array_ignore_null(1, cast(map('key', 'value') as json)) |
    +--------------------------------------------------------------+
    | [1,{"key":"value"}]                                          |
    +--------------------------------------------------------------+

  5. JSON 문자열은 json_parse로 파싱할 수 있습니다.

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