다음을 통해 공유

explode_outer 테이블 반환 생성기 함수

  • 아티클

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

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

Databricks SQL 및 Databricks Runtime 13.3 LTS 이상에서 이 함수는 명명된 매개 변수 호출을 지원합니다.

구문

explode_outer(collection)

인수

  • collection: 식 ARRAY 입니다 MAP .

반품

배열의 요소 또는 지도의 키와 값으로 구성된 행 집합입니다. explode_outer에 의해 생성된 배열의 열은 col로 명명됩니다. 맵의 열은 key, value이라고 합니다.

collection NULL이 배열 또는 맵 값에 대한 NULL가 포함된 단일 행을 생성합니다. explode() 함수를 사용할 때 collectionNULL 행을 반환하지 않습니다.

  • 적용 대상:예로 표시된 확인 Databricks Runtime 12.1 이하:

    explode_outer는 식의 루트이거나 LATERAL VIEW뒤에 올 때만 SELECT 목록에 배치할 수 있습니다. 함수를 SELECT 목록에 배치할 때 동일한 SELECT 목록에 다른 생성기 함수가 있으면 안 됩니다. 그렇지 않으면 UNSUPPORTED_GENERATOR.MULTI_GENERATOR 오류가 발생합니다.

  • check marked yes적용 대상: Databricks SQL Databricks Runtime 12.2 LTS 이상:예로 표시된 확인

    LATERAL VIEW 절 또는 SELECT 목록의 호출은 더 이상 사용되지 않습니다. 대신 table_reference 호출 explode_outer합니다.

예제

적용 대상:예로 표시된 확인 Databricks Runtime 12.1 이하:

> SELECT explode_outer(array(10, 20)) AS elem, 'Spark';
 10 Spark
 20 Spark

> SELECT explode_outer(collection => array(10, 20)) AS elem, 'Spark';
 10 Spark
 20 Spark

> SELECT explode_outer(map(1, 'a', 2, 'b')) AS (num, val), 'Spark';
 1   a   Spark
 2   b   Spark

> SELECT explode_outer(cast(NULL AS array<int>)), 'Spark';
 NULL   Spark

> SELECT explode_outer(array(1, 2)), explode_outer(array(3, 4));
  Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR

-- The difference between explode() and explode_outer() is that explode_outer() returns NULL if the array is NULL.
> SELECT explode_outer(c1) AS elem, 'Spark' FROM VALUES(array(10, 20)), (null) AS T(c1);
 10   Spark
 20   Spark
 NULL Spark

> SELECT explode(c1) AS elem, 'Spark' FROM VALUES(array(10, 20)), (null) AS T(c1);
 10 Spark
 20 Spark

check marked yes적용 대상: Databricks SQL Databricks Runtime 12.2 LTS 이상:예로 표시된 확인

> SELECT elem, 'Spark' FROM explode_outer(array(10, 20)) AS t(elem);
 10 Spark
 20 Spark

> SELECT num, val, 'Spark' FROM explode_outer(map(1, 'a', 2, 'b')) AS t(num, val);
 1   a   Spark
 2   b   Spark

> SELECT * FROM explode_outer(array(1, 2)), explode_outer(array(3, 4));
 1   3
 1   4
 2   3
 2   4

> SELECT * FROM explode_outer(cast(NULL AS array<int>));
 NULL

-- Using lateral correlation in Databricks 12.2 and above
> SELECT * FROM explode_outer(array(1, 2)) AS t, LATERAL explode_outer(array(3 * t.col, 4 * t.col));
 1   3
 1   4
 2   6
 2   8