variant_explode_outer 테이블 값 함수

다음에 적용됨: Databricks SQL Databricks Runtime 15.3 이상

외부 의미 체계를 사용하여 variantExpr 중첩 해제하여 행 집합을 반환합니다.

구문

variant_explode_outer ( variantExpr )

주장

• variantExpr: VARIANT 표현식으로, VARIANT 개체 또는 VARIANT ARRAY를 나타냅니다.

반품

VARIANT ARRAY요소 또는 VARIANT 개체의 키와 값으로 구성된 행 집합입니다. variant_explode 생성되는 열은 다음과 같습니다.

• pos INT
• key STRING
• value VARIANT;

VARIANT 개체를 분해할 때 출력 key 및 value 열은 개체의 키와 값을 나타냅니다. VARIANT 배열을 분해할 때 출력 key 항상 null이며 출력 value 열은 배열의 요소를 나타냅니다.

variantExpr이 NULL인 경우, 또는 하나 이상의 요소가 있는 VARIANT ARRAY나 하나 이상의 필드가 있는 OBJECT가 아닌 경우 단일 NULL 행이 생성됩니다. 이 경우 행을 반환하지 않는 경우 variant_explode 함수를 사용합니다.

예제

-- Simple example
> SELECT *
   FROM variant_explode_outer(parse_json('[1, "a", {"b": "hello"}]'));
  pos  key  value
  ---  ---- -------------
    0  NULL 1
    1  NULL "a"
    2  NULL {"b":"hello"}

> SELECT *
    FROM variant_explode_outer(parse_json('{"foo":1,"bar":"hello"}'));
  pos  key  value
  ---  ---- -------------
    0  bar  "hello"
    1  foo  1

 -- null input
> SELECT value FROM variant_explode_outer(null) AS t(pos, key, value);
  null

-- Not an array or object input
> SELECT value FROM variant_explode_outer(parse_json('123')) AS t(pos, key, value);
  null

-- Using lateral correlation
> SELECT t.value AS outer, u.value AS inner
    FROM variant_explode_outer(parse_json('[[1, 2], [3, 4]]')) AS t,
    LATERAL variant_explode(t.value) AS u;
  outer inner
  ----- -----
  [1,2]     1
  [1,2]     2
  [3,4]     3
  [3,4]     4

관련된 함수

• variant_explode 테이블 값 반환 함수