GET_IGNORE_CASE¶

구문¶

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

GET_IGNORE_CASE( <object> , <field_name> )

GET_IGNORE_CASE( <variant> , <field_name> )

MAP

GET_IGNORE_CASE( <map> , <key> )

인자¶

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      |
+--------+

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

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

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

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