다음을 통해 공유


variant_get 기능

적용 대상: 예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime 15.3 이상

로 지정된 path형식variantExpr의 값을 추출합니다.

구문

variant_get ( variantExpr, path, type )

인수

  • variantExpr: VARIANT 식입니다.
  • pathSTRING: 올바른 형식의 JSON 경로 식이 있는 리터럴입니다.
  • typeSTRING: 형식을 정의하는 리터럴입니다.

반품

type 형식의 값입니다.

개체를 찾을 NULL 수 없으면 반환됩니다. 개체를 찾았지만 원하는 형식으로 캐스팅할 수 없는 경우 Azure Databricks가 발생합니다 INVALID_VARIANT_CAST. 오류 대신 반환 NULL 하려면 try_variant_get 함수를 사용합니다.

예제

-- Simple example
> SELECT variant_get(parse_json('{"key": 123, "data": [4, {"a": "hello"}, "str"]}'), '$.data[1].a', 'string')
  hello

-- missing path
> SELECT variant_get(parse_json('{"key": 123, "data": [4, {"a": "hello"}, "str"]}'), '$.missing', 'int')
  null

-- Invalid cast
> SELECT variant_get(parse_json('{"key": 123, "data": [4, {"a": "hello"}, "str"]}'), '$.key', 'array<int>')
  Error: INVALID_VARIANT_CAST.