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
.
NULL
배열 또는 맵 값에 대한 s가 있는 NULL
단일 행인 경우 collection
생성됩니다.
explode() 함수를 사용할 때 NULL
collection
행을 반환하지 않습니다.
적용 대상: Databricks Runtime 12.1 이하:
explode_outer
는 식의SELECT
루트 또는 LATERAL VIEW 다음에만 목록에 배치할 수 있습니다. 함수SELECT
를 목록에 배치할 때 동일한SELECT
목록이나 UNSUPPORTED_GENERATOR 다른 생성기 함수가 없어야 합니다. MULTI_GENERATOR 발생합니다.적용 대상: 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
적용 대상: 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