카테고리:

반정형 및 정형 데이터 함수 (추출)

GET_IGNORE_CASE

오브젝트에서 필드 값을 추출합니다. 인자 중 하나가 NULL이면 NULL을 반환합니다.

참고

이 함수는 GET 과 유사하지만, 필드 이름에 대해 대/소문자를 구분하지 않는 일치를 적용합니다.

참고 항목:

GET

구문
Copy

OBJECT (또는 OBJECT를 포함하는 VARIANT)

GET_IGNORE_CASE( <object> , <field_name> )

GET_IGNORE_CASE( <variant> , <field_name> )
Copy

MAP

GET_IGNORE_CASE( <map> , <key> )
Copy

인자

variant

ARRAY 또는 OBJECT가 포함된 VARIANT 로 평가되는 식입니다.

object

키-값 페어를 포함하는 OBJECT 로 평가되는 식입니다.

field_name

VARCHAR로 평가되는 식입니다. 값을 검색할 키-값 페어의 키를 지정합니다.

field_name 은 빈 문자열이 아니어야 합니다.

object 가 정형 OBJECT 인 경우 field_name 에 대한 상수를 지정해야 합니다.

object 에 지정된 키가 포함되지 않은 경우:

  • object 가 반정형 OBJECT인 경우 함수는 NULL을 반환합니다.

  • object 가 정형 OBJECT인 경우 오류가 발생합니다.

map

MAP 으로 평가되는 식입니다.

key

값을 검색할 키-값 페어의 키입니다.

map 에 지정된 키가 없으면 함수는 NULL을 반환합니다.

반환

  • 반환된 값은 ARRAY의 지정된 요소 또는 OBJECT의 키-값 페어에 지정된 키에 해당하는 값입니다.

  • 입력 오브젝트가 반정형 OBJECT, ARRAY 또는 VARIANT인 경우 함수는 VARIANT를 반환합니다. 데이터 타입은 VARIANT입니다. 왜냐하면,

    • ARRAY에서 각 요소가 VARIANT 타입입니다.

    • OBJECT에서 각 키-값 페어의 값이 VARIANT 타입니다.

  • 입력 오브젝트가 정형 OBJECT, 정형 ARRAY 또는 MAP 인 경우 함수는 오브젝트에 대해 지정된 유형의 값을 반환합니다.

    예를 들어 입력 오브젝트의 유형이 ARRAY(NUMBER)인 경우 함수는 NUMBER를 반환합니다.

사용법 노트

  • 이 함수는 첫 번째로 찾은 정확히 일치하는 항목을 반환합니다. 이 함수가 모호한(대/소문자를 구분하지 않는) 일치 항목만 찾은 경우, 일치 항목 중 하나에 대한 값을 반환합니다. 그러나 어느 모호한 필드 이름이 첫 번째로 일치하는지는 보장할 수 없습니다.

  • GET_IGNORE_CASE은 다음과 같은 방법으로 호출할 수 있는 이진 함수입니다.

    • object 는 OBJECT 값이며 field_name 은 문자열 값으로, 이는 상수 또는 식일 수 있습니다.

      GET_IGNORE_CASE의 이 변형은 오브젝트 값에서 제공된 이름을 가진 필드의 값을 추출합니다.

    • v 는 VARIANT 값이며 field_name 은 문자열 값으로, 이는 상수 또는 식일 수 있습니다.

      object 를 사용하는 GET_IGNORE_CASE와 유사하게 작동하지만, v 에 오브젝트 값이 포함되어 있는지를 추가로 확인합니다(v 에 오브젝트가 포함되지 않은 경우 NULL을 반환함).

예

오브젝트에서 필드 값을 추출합니다. 함수는 정확히 일치하는 항목을 반환합니다.

SELECT GET_IGNORE_CASE(TO_OBJECT(PARSE_JSON('{"aa":1, "aA":2, "Aa":3, "AA":4}')),'aA') as output;

+--------+
| OUTPUT |
|--------|
| 2      |
+--------+
Copy

오브젝트에서 필드 값을 추출합니다. 함수는 정확히 일치하는 항목을 찾을 수 없으므로 모호한 일치 항목 중 하나를 반환합니다.

SELECT GET_IGNORE_CASE(TO_OBJECT(PARSE_JSON('{"aa":1, "aA":2, "Aa":3}')),'AA') as output;

+--------+
| OUTPUT |
|--------|
| 3      |
+--------+
Copy

자세한 예는 반정형 데이터 쿼리하기 를 참조하십시오.

언어: 한국어