Поделиться через

Функция генератора табличных значений explode_outer

  • Статья

Область применения: флажок Databricks SQL флажок Databricks Runtime

Возвращает набор строк путем отмены вложения collection с помощью внешней семантики.

В Databricks SQL и Databricks Runtime 13.3 LTS и выше эта функция поддерживает вызов именованных параметров.

Синтаксис

explode_outer(collection)

Аргументы

  • collection: выражение или MAP выражениеARRAY.

Возвраты

Набор строк, состоящих из элементов массива или ключей и значений карты. Столбец, созданный explode_outer массивом, называется col. Столбцы для карты вызываются key и value.

Если collection имеется NULL одна строка с NULLзначениями массива или карты. Чтобы возвращать строки, если collection используется NULL функция взрыва().

  • Применимо к: Databricks Runtime 12.1 и более ранних версий: флажок

    explode_outer можно поместить только в список в SELECT качестве корневого элемента выражения или после бокового представления. При размещении функции в списке SELECT не должно быть другой функции генератора в том же SELECT списке или UNSUPPORTED_GENERATOR. MULTI_GENERATOR вызывается.

  • Применимо к: флажок Databricks SQL флажок Databricks Runtime 12.2 LTS и выше:

    Вызов из предложения LATERAL VIEW или SELECT списка не рекомендуется. Вместо этого вызовите explode_outer как table_reference.

Примеры

Применимо к: 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