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

JSON_EXTRACT_BIGINT

설명​

JSON_EXTRACT_BIGINT는 JSON 객체에서 <json_path>로 지정된 필드를 추출하여 BIGINT 타입으로 변환합니다.

구문​

JSON_EXTRACT_BIGINT(<json_object>, <json_path>)

매개변수​

  • <json_object>: JSON 타입으로, 값을 추출할 대상 매개변수입니다.
  • <json_path>: String 타입으로, 대상 JSON에서 추출할 요소를 지정하는 JSON 경로입니다.

반환값​

Nullable(BIGINT): 추출한 BIGINT 값을 반환하며, 일부 경우에는 NULL을 반환합니다.

사용 시 참고 사항​

  1. <json_object> 또는 <json_path>가 NULL이면 NULL을 반환합니다.
  2. <json_path>로 지정된 요소가 없으면 NULL을 반환합니다.
  3. <json_path>로 지정된 요소를 BIGINT로 변환할 수 없으면 NULL을 반환합니다.
  4. 동작은 "cast + json_extract"와 동일하며, 다음과 동등합니다:
    CAST(JSON_EXTRACT(<json_object>, <json_path>) as BIGINT)

예제​

  1. 정상적인 매개변수
    SELECT json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id');
    +-------------------------------------------------------------------------+
    | json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id') |
    +-------------------------------------------------------------------------+
    | 122222222222223 |
    +-------------------------------------------------------------------------+
  2. 경로가 없는 경우
    SELECT json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id2');
    +--------------------------------------------------------------------------+
    | json_extract_bigint('{"id": 122222222222223, "name": "doris"}', '$.id2') |
    +--------------------------------------------------------------------------+
    | NULL |
    +--------------------------------------------------------------------------+
  3. NULL 매개변수
    SELECT json_extract_bigint('{"id": 122222222222223, "name": "doris"}', NULl);
    +-----------------------------------------------------------------------+
    | json_extract_bigint('{"id": 122222222222223, "name": "doris"}', NULl) |
    +-----------------------------------------------------------------------+
    | NULL |
    +-----------------------------------------------------------------------+
    SELECT json_extract_bigint(NULL, '$.id2');
    +------------------------------------+
    | json_extract_bigint(NULL, '$.id2') |
    +------------------------------------+
    | NULL |
    +------------------------------------+
  4. BIGINT로 변환할 수 없는 경우
    SELECT json_extract_bigint('{"id": 123, "name": "doris"}','$.name');
    +--------------------------------------------------------------+
    | json_extract_bigint('{"id": 123, "name": "doris"}','$.name') |
    +--------------------------------------------------------------+
    | NULL |
    +--------------------------------------------------------------+