VARIANT 형식

적용 대상: Databricks SQL Databricks Runtime 15.3 이상

중요하다

이 기능은 공개 프리뷰.

반구조화된 데이터를 나타냅니다.

구문

VARIANT

제한

이 형식은 , STRUCTARRAY및 스칼라 형식을 비롯한 MAP반구조화된 데이터 저장을 지원합니다. VARIANT는 STRING 유형의 키를 가진 MAP 유형만 저장할 수 있습니다.

리터럴 (프로그래밍 등에서 사용하는 정해진 값)

VARIANT 값을 만드는 방법에 대한 자세한 내용은 parse_json 함수 함수를 참조하세요. CAST 함수를 사용하여 특정 유형의 리터럴을 VARIANT로 변환할 수도 있습니다.

노트

• VARIANT에서 값을 추출하려면 사용할 수 있습니다.
  • variant_get 함수는 복합 형식으로 이동하는 JSON 경로 식 사용하여.
  • :(콜론 기호)의 연산자를 사용하여 JSON 경로 표현식으로 VARIANT을 구문 분석하는.
  • try_variant_get 함수는 JSON 경로를 사용하여 오류 관용이 있는 복합 형식으로 탐색하는.
  • cast 함수 또는 ::(콜론 콜론 기호) 연산자를 사용하여 VARIANT을 특정 형식으로 캐스팅합니다.
  • try_cast 함수는 VARIANT을(를) 특정 형식으로 캐스팅하며 오류를 허용하는 기능입니다.
• VARIANT 값의 형식을 검사하려면 사용하십시오.
  • 개별 값에 대한 schema_of_variant 함수.
  • 값 컬렉션에 대한 집계 함수 schema_of_variant_agg.

예제

> SELECT parse_json('{"key": 123, "data": [4, 5, "str"]}');
  {"data":[4,5,"str"],"key":123}

> SELECT parse_json(null);
  null

> SELECT parse_json('123');
  123

> SELECT CAST(123.456 AS VARIANT);
  1.456

관련

• :: (이중 콜론 기호) 연산자
• cast 함수
• parse_json 함수
• schema_of_variant 함수
• schema_of_variant_agg 집계 함수
• try_cast 함수
• try_variant_get 함수
• variant_get 함수